Hey Chris, I'm in Switzerland discovering their keyboard layout while trying to separate out the belgian layout from mz fingers so bear with me.
The return to docbook was because: 1) we can't generate coherent pdf's w/ confluence 2) real doc writing (not snippets) requires heavy cycles of edit review reedit which I can do locally with ctrl-R rather than waiting for 20 odd seconds for confluence 3) we have no backup on codehaus' conflu For now what really matters is text and images not the particular editing format. So it's docbook until there's a reason to change. --adrian On 8/25/06, Chris Holmes <[EMAIL PROTECTED]> wrote: > > > Jody Garnett wrote: > > Chris Holmes wrote: > >> First off I apologize for not fully reading this thread, I've been on > >> vacation and there's just a pile of email waiting. If this question > >> has been resolved just point me at the relevant discussions. > >> > >> But _why_ are we reverting back to docbook? A few years ago we moved > >> to wiki to get _away_ from docbook. The thought was to lower the > >> barrier to entry for new contributors, just put all the docs on a > >> wiki. And I think this worked pretty well, we have far more content > >> than we did before. > > Because I can no longer ask ACuster to waste his time, we have been > > unable to move off codehaus (even to the facilities you offered) because > > of XML export failing. > > > > To sum up: GeoTools Developers guide worked on the wiki, and now the > > document is mostly in stable, it is easy to maintain etc... > > GeoTools Users Guide is a mess, I have tried to delete the whole thing > > twice now as it does more damage then good in current form. ACuster is > > trying to put together a replacement (the only volunteer in a couple > > years) and confluence is not working out for him. > >> I concede that without a solid maintainer it's spiraled a bit out of > >> control. But wiki lets you do pdf export and the like, so I'm not > >> sure I understand the advantages of docbook? And the disadvantages > >> are clear and proven for us, we get less documentation contributions > >> when users have to check out and commit on svn just to add a line or > >> two to the docs= > > pdf is not working, the pages are not ordered and the bug does not look > > to be on a schedule to get it fixed. > Ok, cool. Sorry for not wading through all the original emails. So is > the developers guide staying in wiki? Or is someone porting that? > > C > > > > > > > !DSPAM:1003,44eebd1096551665516417! > > > > -- > Chris Holmes > The Open Planning Project > http://topp.openplans.org > > > ------------------------------------------------------------------------- Using Tomcat but need to do more? Need to support web services, security? Get stuff done quickly with pre-integrated technology to make your job easier Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 _______________________________________________ Geotools-devel mailing list Geotools-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geotools-devel
