David Crossley wrote: > David Crossley wrote: > > David Crossley wrote: > > > David Crossley wrote: [snip] > > > > > > > > Assuming that we don't want to version the top-level docs. > > > > > > Is that a legitimate assumption? It would change our layout if we do. > > > I don't know the answer yet either. > > > > > > > f.a.o/ ... the top-level docs, from trunk/site-author > > > > f.a.o/docs/ ... is .htaccess to redirect to current release docs. > > > > f.a.o/docs/0.6/ ... from the forrest_06_branch (*) > > > > f.a.o/docs/0.7/ ... from the forrest_07_branch, when it is released > > > > f.a.o/docs/0.8/ ... the next development, from future trunk/docs-author/ > > > > Let us see what the other solution would be. > > (Say that "current release" is 0.7) > > > > f.a.o/ ... the top-level docs, .htaccess to redirect to 0.7 top-level > > f.a.o/docs/ ... .htaccess to redirect to 0.7/docs/ > > f.a.o/0.6/ ... from the forrest_06_branch > > f.a.o/0.6/docs/ ... from the forrest_06_branch > > f.a.o/0.7/ ... from the forrest_07_branch/site-author/ > > f.a.o/0.7/docs/ ... from the forrest_07_branch/docs-author/ > > f.a.o/0.8/ ... the next development, from the trunk/site-author/ > > f.a.o/0.8/docs/ ... from the trunk/docs-author/
Ross Gardler wrote in another thread: > >Date: Mon Apr 4 15:13:48 2005 > >URL: http://svn.apache.org/viewcvs?view=rev&rev=160109 > >Log: > >Deployment of org.apache.forrest.plugin.OpenOffice.org plugin (deployed by > >'deploy' target of plugin build script) > > > >Added: > > forrest/site/plugins/docs/org.apache.forrest.plugin.OpenOffice.org/ > > forrest/site/plugins/docs/org.apache.forrest.plugin.OpenOffice.org/skin/ > > > > forrest/site/plugins/docs/org.apache.forrest.plugin.OpenOffice.org/skin/screen.css > > OK, I'm experimenting with auto generating plugin docs, so you may see a > few of these kinds of commits over then next week as I grab an hour here > an hour there. But I have some questions. > > I've not really kept up to date with the docs discussions, either the > first round or this round. I'm afraid they slipped underneath my "full > attention" threshold. Now I find I should have kept up. > > How do people suggest I integrate the plugin docs with the main website > docs? If they went under docs/plugins/$plugin-name/ then they will fit better with the versioning system described above. > As the above commit shows, I have a new deploy target that will update > the docs at forrest.apache.org/plugins/docs/PLUGIN-NAME each time a > plugin is deployed with "ant deploy" > > I intend to create an index page to go into that directory from the > plugins.xml file. > > How do we link from the main docs-author (or site-author?) part of the site? If we use docs/plugins/ then it will intergrate easily. --David
