chiark / gitweb /
website: new client has implications for devel page too
[ypp-sc-tools.web-live.git] / yarrg / web / devel
index b296d14bec121b950da7f5b275cc498e5942db58..b3a06e3a71450ab5f937019b572fea1a02befc05 100755 (executable)
 
 
 </%doc>
-<html lang="en"><head>
-<title>YARRG (Yet Another Revenue Research Gatherer)</title>
-<link rel="stylesheet" type="text/css" href="style.css">
-</head><body>
-
-<div class="navoptbar">
-<a href="lookup">YARRG</a> -
- Yet Another Revenue Research Gatherer
-|
-<a href="intro">introduction</a>
-|
-<a href="docs">documentation</a>
-|
-<b>development</b>
-</div>
-<div class="docs">
-
+<& docshead &>
 <h1>YARRG development, contribution and troubleshooting</h1>
 
 <h2>Free Software (aka Open Source) licensing</h2>
@@ -66,16 +50,23 @@ Note that there is <strong>NO WARRANTY</strong> !
 
 <h2>Resources for developers</h2>
 
+For information about the YARRG JPCTB uploader, see the
+<a href="upload">page about the uploader</a>.
+
 <h3>Source code</h3>
 
+<kbd>git clone git://git.yarrg.chiark.net/ypp-sc-tools.main.git</kbd><br>
+clones the master tree through which we push most changes.
+<p>
+
 <kbd>git clone http://www.chiark.greenend.org.uk/~ijackson/ypp-sc-tools/master/.git/</kbd><br>
 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
 <a href="http://www.chiark.greenend.org.uk/~ijackson/ypp-sc-tools/master/">as
 an unpacked tree</a>
 
 <p><a href="source.tar.gz">Live website source code</a> 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
@@ -87,10 +78,12 @@ gives you the source code for the pages you are now looking at.
 <h4>Lookup website</h4>
  <ul>
  <li><a href="http://yarrg.chiark.net/">Main released site</a>,
-     with <a href="http://yarrg.chiark.net/source.tar.gz">source code</a>
+     with <a href="http://yarrg.chiark.net/source.tar.gz">source code</a> (and
+   <a href="git://git.yarrg.chiark.net/ypp-sc-tools.web-live.git">committed changes via git</a>)
  <li><a href="http://yarrg.chiark.net/test/data">Released code; testing database instance (updated with yarrg --test-servers)</a> (source code as above)
  <li><a href="http://yarrg.chiark.net/test/code">Testing version of the site code</a>,
-     with <a href="http://yarrg.chiark.net/test/source.tar.gz">source code</a>
+     with <a href="http://yarrg.chiark.net/test/code/source.tar.gz">source code</a> (and
+   <a href="git://git.yarrg.chiark.net/ypp-sc-tools.web-test.git">committed changes via git</a>)
  <li><a href="http://yarrg.chiark.net/test/both">Testing code running against the testing database instance</a> (source code as above)
  </ul>
 
@@ -108,14 +101,17 @@ are normally accessed only via the upload client but you may also
 download their source directly:
 
  <ul>
- <li><a href="http://upload.yarrg.chiark.net/commod-update-receiver?get_source=1">Main production instance</a>
- <li><a href="http://upload.yarrg.chiark.net/test/commod-update-receiver?get_source=1">Testing database instance</a>
+ <li><a href="http://upload.yarrg.chiark.net/commod-update-receiver?get_source=1">Main production instance</a> including uncommitted changes; or
+   <a href="git://git.yarrg.chiark.net/ypp-sc-tools.db-live.git">committed changes via git</a>
+ <li><a href="http://upload.yarrg.chiark.net/test/commod-update-receiver?get_source=1">Testing database instance</a> including uncommitted changes; or
+   <a href="git://git.yarrg.chiark.net/ypp-sc-tools.db-test.git">committed changes via git</a>
  </ul>
 
 <h3>Data</h3>
 
 <kbd>rsync rsync.yarrg.chiark.net::yarrg/</kbd><br>
-accesses files published for the benefit of the yarrg upload client,
+accesses files published for the benefit of the old yarrg upload client
+and other members of the ypp-sc-tools family.
 
 <p>
 
@@ -141,10 +137,10 @@ has the specification of the mechanism and format for uploading to YARRG.
 
 If you would like to run a (perhaps modified) copy of the YARRG
 website it would be very easy for us to make our system send you
-copies of updates submitted by users of the official YARRG client, in
-the format expected by the YARRG code.  Please just ask us - at our
-end it's just a matter of us adding your database instance's special
-email address to our alias file.
+copies of updates submitted by users of the YARRG clients including
+YARRG JPCTB, in the format expected by the YARRG code.  Please just
+ask us - at our end it's just a matter of us adding your database
+instance's special email address to our alias file.
 
 <p>
 
@@ -159,5 +155,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.
 
+<p>
 </div>
 <& footer, isdevel => 1 &>