Author: sebb
Date: Sat Apr 28 13:41:06 2018
New Revision: 1830452
URL: http://svn.apache.org/viewvc?rev=1830452&view=rev
Log:
Clarify alternate strategy
Modified:
attic/site/xdocs/process.xml
Modified: attic/site/xdocs/process.xml
URL:
http://svn.apache.org/viewvc/attic/site/xdocs/process.xml?rev=1830452&r1=1830451&r2=1830452&view=diff
==============================================================================
--- attic/site/xdocs/process.xml (original)
+++ attic/site/xdocs/process.xml Sat Apr 28 13:41:06 2018
@@ -150,16 +150,25 @@ ${Name} on behalf of ${project} + the At
<ul>
<li>in xdocs/projects/ copy one of the files to the new project name (eg.
devicemap.xml)</li>
+ <li>TBA: how to determine the file name</li>
<li>Add the new file as a link in the xdocs/stylesheets/project.xml
navigation</li>
<li>Run 'ant' from the root (ie: the attic/site/ directory you checked
out)</li>
<li>Review the generated files in docs/** in your browser</li>
- <li>SVN commit all changes. Remember to add both the new xdocs/ project
file and the new generated docs/ project file
- N.B. the buildbot will detect any changes to the source and build/commit
the outout.
- So it's important to checkin all the changes at once. Or just checkin the
source changes and let buildbot do the rest.
+ <li>SVN commit *all* changes. Remember to add both the new xdocs/ project
file and the new generated docs/ project file
</li>
<li>The new pages should go live quickly</li>
</ul>
-
+
+ <p>To make minor edits to existing pages:</p>
+ <ul>
+ <li>edit the page(s)</li>
+ <li>Commit the updated pages</li>
+ <li>The buildbot will build the site and commit the result which will be
published soon after</li>
+ <li>This is most suitable for minor changes when there is no need to
review the output before committing.
+ Otherwise use the process described previously.
+ </li>
+ </ul>
+
</section>
<section id="svnkarma">
