forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: xml-forrest/src/documentation/content/xdocs your-project.xml
Date Mon, 19 Aug 2002 03:58:49 GMT
crossley    2002/08/18 20:58:49

  Modified:    src/documentation/content/xdocs your-project.xml
  Minor text tweaks: forrestbot -> ForrestBot; our -> your
  Revision  Changes    Path
  1.2       +26 -13    xml-forrest/src/documentation/content/xdocs/your-project.xml
  Index: your-project.xml
  RCS file: /home/cvs/xml-forrest/src/documentation/content/xdocs/your-project.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- your-project.xml	18 Aug 2002 07:44:56 -0000	1.1
  +++ your-project.xml	19 Aug 2002 03:58:49 -0000	1.2
  @@ -23,11 +23,22 @@
  -   The <strong>forrestbot</strong> will automatically build and publish your
  -   documentation on a regular basis. This document provides a concise overview.
  -   See
  +   The <strong>ForrestBot</strong> will automatically build and publish your
  +   documentation on a regular basis. The versatile ForrestBot can retrieve
  +   source XML instances from various type of repository (e.g. local filesystem,
  +   local CVS, remote CVS), generate the documents, and copy the result to a
  +   local or remote location (optionally via secure methods). It can be run
  +   from the command-line as part of your documentation edit-build-review cycle,
  +   it can be called from cron to automate your website update, it can operate
  +   as a centralised docs-build service for a set of remote projects, it can do
  +   tasks in parallel, and do even more.
  +  </p>
  +  <p>
  +   This document provides a concise overview of one particular scenario. See
      <link href="forrestbot.html">The ForrestBot</link> for details and understand
      <link href="forrest-contract.html">Our Contract</link>.
  +   Please send your feedback to <code>forrest-dev</code> - the ForrestBot
  +   will be enhanced to meet diverse needs.
      (Building the documentation for the actual Forrest project is a separate
  @@ -39,13 +50,13 @@
     <title>Establish project source directory</title>
  -  <p>The directory that contains our XML instances.</p>
  +  <p>The directory that contains your XML instances.</p>
      <li><code>PROJECT_HOME = /home/you/yourproject</code></li>
      <li><code>SRC_DOC = $PROJECT_HOME/src/documentation</code></li>
  -   Our XML instance documents are at <code>$SRC_DOC/content/xdocs</code>
  +   Your XML instance documents are at <code>$SRC_DOC/content/xdocs</code>
  @@ -72,10 +83,11 @@
  -  <title>Run forrestbot</title>
  +  <title>Run ForrestBot</title>
  -./ bot \
  +[you@localhost] cd $FORREST_HOME
  +[you@localhost] ./ clean
  +[you@localhost] ./ bot \
   -Dbot.forrestbot.xconf=$PROJECT_HOME/yourproject.conf.xml \
  @@ -83,18 +95,19 @@
     <title>Next Steps</title>
  -  <p>Some enhancements to our local forrestbot would be ...</p>
  +  <p>Some enhancements to your local ForrestBot would be ...</p>
  -   <li>Add our own skin at 
  +   <li>Add your own skin at 
      <code>$SRC_DOC/skins/yourproject</code> by copying one of the skins from
      <code>$FORREST_HOME/src/resources/skins</code> (use basic or forrest-site)
      <li>Configure another <code><![CDATA[<project>]]></code>
to conduct a secure
  -     copy to our public website.
  +     copy to your public website.
  -   <li>Get it to send us email about forrestbot activities.
  +   <li>Manage your XML instances with CVS and instruct ForrestBot to get
  +     the source.
  -   <li>Send our feedback to <code>forrest-dev</code>
  +   <li>Get it to send you email about ForrestBot activities.

View raw message