incubator-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r239396 - in /incubator/public/trunk: site-author/howtoparticipate.html site-publish/howtoparticipate.html site-publish/howtoparticipate.pdf
Date Tue, 23 Aug 2005 12:07:34 GMT
Author: crossley
Date: Tue Aug 23 05:07:28 2005
New Revision: 239396

URL: http://svn.apache.org/viewcvs?rev=239396&view=rev
Log:
Emphasise that people can just commit the source changes
and someone else will publish it.

Modified:
    incubator/public/trunk/site-author/howtoparticipate.html
    incubator/public/trunk/site-publish/howtoparticipate.html
    incubator/public/trunk/site-publish/howtoparticipate.pdf

Modified: incubator/public/trunk/site-author/howtoparticipate.html
URL: http://svn.apache.org/viewcvs/incubator/public/trunk/site-author/howtoparticipate.html?rev=239396&r1=239395&r2=239396&view=diff
==============================================================================
--- incubator/public/trunk/site-author/howtoparticipate.html (original)
+++ incubator/public/trunk/site-author/howtoparticipate.html Tue Aug 23 05:07:28 2005
@@ -112,6 +112,9 @@
 <p>People with commit access to the "incubator" SVN can edit the
             source documents in the "site-author/" directory. Anyone else can send
             patches to those documents.</p>
+<p><b>Note:</b> You can just commit the source changes and leave it to
someone
+            else to generate the website.
+            </p>
             <p>It is <b>strongly</b> suggested to use plain HTML for the
source files. 
                Forrest understands them even if malformed, and generates the site
                in any case. Use any HTML editor that you prefer, as long as it 
@@ -128,9 +131,6 @@
 	          and 
 	          <a href="http://forrest.apache.org/docs/wiki-sample.html">JSPWiki format</a>
 </p>
-<p>You can just commit the source changes and leave it to someone
-            else to generate the website.
-            </p>
 <p>Note: Converting from wiki source to html source. A conversion run has been already
done.
 Do: cd site-author/projects; svn mv mine.cwiki mine.html' and then edit it to replace the
old content
 with that from projects/TEMP_HTML/mine.html</p>

Modified: incubator/public/trunk/site-publish/howtoparticipate.html
URL: http://svn.apache.org/viewcvs/incubator/public/trunk/site-publish/howtoparticipate.html?rev=239396&r1=239395&r2=239396&view=diff
==============================================================================
--- incubator/public/trunk/site-publish/howtoparticipate.html (original)
+++ incubator/public/trunk/site-publish/howtoparticipate.html Tue Aug 23 05:07:28 2005
@@ -317,13 +317,14 @@
 <a name="N10084"></a><a name="Edit+the+content"></a>
 <h4>Edit the content</h4>
 <p>People with commit access to the "incubator" SVN can edit the source documents in
the "site-author/" directory. Anyone else can send patches to those documents.</p>
+<p>
+<strong>Note:</strong> You can just commit the source changes and leave it to
someone else to generate the website.</p>
 <p>It is <strong>strongly</strong> suggested to use plain HTML for the
source files. Forrest understands them even if malformed, and generates the site in any case.
Use any HTML editor that you prefer, as long as it doesn't mess up too much with the source
tags.</p>
 <p>You have a choice of source formats to use: plain HTML, the document-v* series of
xdocs, JSPWiki, others formats which we are not encouraging here. Keep it simple.</p>
 <p>When editing xml source, please ensure xml validation (forrest will). When editing
simple JSPWiki source, please take care to use the correct syntax (forrest cannot). Here are
examples of the source document structures: <a href="/">html format</a> and <a
href="http://forrest.apache.org/docs/document-v12.html">xml format</a> and <a
href="http://forrest.apache.org/docs/wiki-sample.html">JSPWiki format</a>
 </p>
-<p>You can just commit the source changes and leave it to someone else to generate
the website.</p>
 <p>Note: Converting from wiki source to html source. A conversion run has been already
done. Do: cd site-author/projects; svn mv mine.cwiki mine.html' and then edit it to replace
the old content with that from projects/TEMP_HTML/mine.html</p>
-<a name="N100A2"></a><a name="Generate+the+production+documents"></a>
+<a name="N100A4"></a><a name="Generate+the+production+documents"></a>
 <h4>Generate the production documents</h4>
 <p>Either install Apache Forrest locally so that you can edit and review documents
immediately, or use the production system on the server to generate and copy to a staging
site to view them. In the future there will be automated generation and staging systems.</p>
 <p>Lets explain the server-side method first, then go on to explain how to set up a
local Forrest system.</p>
@@ -348,7 +349,7 @@
 cd /www/incubator.apache.org
 svn update
 </pre>
-<a name="N100AF"></a><a name="Using+a+local+Forrest+installation"></a>
+<a name="N100B1"></a><a name="Using+a+local+Forrest+installation"></a>
 <h4>Using a local Forrest installation</h4>
 <p>Install the current release of <a href="http://forrest.apache.org/">Apache
Forrest</a> (v0.6 release or SVN branch "forrest_06_branch") by following the instructions
at the index.html in the distribution, to set the environment variables $FORREST_HOME and
$PATH.</p>
 <p>Checkout the incubator SVN repository. The site source files are kept in the "incubator"
SVN at "site-author/". The final website contents are kept in the "incubator" SVN at "site-publish/".</p>
@@ -380,11 +381,11 @@
 svn update
           </pre>
 </div>
-<a name="N100EE"></a><a name="Project-specific+resources"></a>
+<a name="N100F0"></a><a name="Project-specific+resources"></a>
 <h2 class="underlined_10">Project-specific resources</h2>
 <div class="section">
 <p>Some <a href="projects/">projects</a> under incubation have their own
mailing lists, or their development discussion occurs on the mailing list of another project.
Check out the project websites to be sure what mailing list is the right one.</p>
-<a name="N100F8"></a><a name="Project+Website+Howto"></a>
+<a name="N100FA"></a><a name="Project+Website+Howto"></a>
 <h3 class="underlined_5">Project Website Howto</h3>
 <p>Each project can use whatever documentation system that it chooses. Perhaps use
a fancy documentation management system like Forrest or Maven, or just use simple raw html
pages.</p>
 <p>Keep your source documents in your project Version Control System. To publish your
site, simply "commit" your final generated documents to your project "site" module.</p>

Modified: incubator/public/trunk/site-publish/howtoparticipate.pdf
URL: http://svn.apache.org/viewcvs/incubator/public/trunk/site-publish/howtoparticipate.pdf?rev=239396&r1=239395&r2=239396&view=diff
==============================================================================
Binary files - no diff available.



---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@incubator.apache.org
For additional commands, e-mail: cvs-help@incubator.apache.org


Mime
View raw message