Andrea are you content with the developers guide? I have found that subscribing to the changes and acting as a editor for months at a time serves as a good way of keeping wiki based docs relevant and useful. > In the meantime, I cannot but notice that the old datastore tutorials, > the map rendering tutorials and so on, whilst outdated, had > more meat than the new guide. Where are those today? Lost in wiki > re-organizations? > I am thinking of a salvage operation, using the UserGuide space w/ a focus on the library (ie put more then brief introductions to geospatial concepts firmly out of scope etc...), combined with answering user email list questions with a wiki page rather then an email and things do start to look better after even a few months. > Oh well, since I'm not writing docs, I should be the last one to > complain, and moreover I don't have any really good alternative. > But let me at least be worried, or sad, whatever. > Indeed. > Sob, when will Geotools be ready for a "Geotools in Action" book? > Or, alternatively, when will we see a documentation system as easy > as HTML, but with good printout control, hierarchical doc support > and the like? I did not mind XXE + simple docbook, but the docs were always out of date. This is all by nature of a tradeoff - tough problems with each solution. > Something that can be edited with the same control as source code, but > viewed online by everyone just as easily, and maybe commented, with > comments sent to the authors automatically, > and so on. Not tomorrow I guess.... > It is to dream of Xanadu :-) At least the Web 2.0 kick has put the readers back in the content generation loop. I do not mind the combination of wiki w/ editor - we probably should of locked down the user docs when we lost our Editor a while back. Live and learn.
Jody ------------------------------------------------------------------------- Take Surveys. Earn Cash. Influence the Future of IT Join SourceForge.net's Techsay panel and you'll get the chance to share your opinions on IT & business topics through brief surveys - and earn cash http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV _______________________________________________ Geotools-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/geotools-devel
