+1 completely agree on the 2 use cases: being able to build locally is useful for complex cases, but avoiding to require it is useful for normal use
this will be one of my expectations when we'll change the build engine: being able to build locally without too much hassle when I want to test complex changes but for normal changes, I don't care of the build tool: buildbot will do the job for me :) Regards, Hervé Le samedi 28 avril 2018, 15:41:07 CEST s...@apache.org a écrit : > 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=18 > 30451&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">