X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~yarrgweb/git?a=blobdiff_plain;f=yarrg%2Fweb%2Fdevel;h=4ff6d04f3b9801172e23c39b36d062a7337cc465;hb=2fc281fdc41a5e7b97550cda3806c903b8a7ae9b;hp=fed459f5b8e1df457e9de2eaf8456944c76b9c3c;hpb=6a4d494e0e31f95bdd6dd54b814e8b2381ad95b2;p=ypp-sc-tools.db-live.git
diff --git a/yarrg/web/devel b/yarrg/web/devel
index fed459f..4ff6d04 100755
--- a/yarrg/web/devel
+++ b/yarrg/web/devel
@@ -33,32 +33,16 @@
%doc>
-
-
-
+<& docshead &>
YARRG development, contribution and troubleshooting
Free Software (aka Open Source) licensing
YARRG is Free Software - you may share and modify it. See the
licences for details. Not only the client but also the website code
-is Free. The yarrg client, support files, and so forth are under
-the GNU GPL (v3 or later); the website is under the GNU Affero GPL (v3
-or later).
+is Free. The yarrg client, support files, and so forth are under the
+GNU GPL (v3 or later); the website and database backend is under the
+GNU Affero GPL (v3 or later).
@@ -66,37 +50,62 @@ Note that there is NO WARRANTY !
Resources for developers
+For information about the YARRG JPCTB uploader, see the
+
page about the uploader.
+
Source code
+
git clone git://git.yarrg.chiark.net/ypp-sc-tools.main.git
+clones the master tree through which we push most changes.
+
+
git clone http://www.chiark.greenend.org.uk/~ijackson/ypp-sc-tools/master/.git/
obtains the source code of the latest version released for use as a
-client, which you can also find
+screenscraper client, which you can also find
as
an unpacked tree
Live website source code can
-be downloaded, in case we have made changes but not yet pushed them
+be downloaded: In case we have made changes but not yet pushed them
(perhaps because we haven't done a release), and to make it easy for
anyone else who runs a copy of the website to provide everyone with
the source for their version, the website code itself lets you download
an up-to-date of its actually-running source code. So this link
gives you the source code for the pages you are now looking at.
-
YARRG lookup website instances
+
YARRG website code instances
+
+
Lookup website
-Each of these allows you to download its own source code so you
-can get both the testing and the main version of the website.
-
You can add the form parameter ?debug=1 to each of the
-above to get a version of the site with debugging output enabled.
+website URLs above to get a version of the site with debugging output enabled.
+
+
Database and dictionary update receiver
+
+On the live system there are different trees, potentially with
+different versions, for receiving updates and managing the database,
+to the ones for displaying the website. The database management trees
+are normally accessed only via the upload client but you may also
+download their source directly:
+
+
Data
@@ -145,5 +154,6 @@ Email Ian Jackson ijackson (at) chiark.greenend.org.uk. Or talk to
any Fleet Officer or above of the crew Special Circumstances on the
Midnight Ocean.
+
<& footer, isdevel => 1 &>