Adrian, The release of the 19123 Primer (draft six) should help people understand coverages. The implementation manual is being written in parallel with the implementation itself. 19123 primer is 69 pgs and the "coverage core" implementation unit is ~20 pages.
Remember Xwindows? There were two sets of documentation: the user's guide and the reference manual. I'm shooting for making the primer be the users guide and the implementation manual be the reference manual. Currently I do not have anything chock full of examples. If we make an "iso coverage" section to a geotools manual, it should perhaps contain many examples and refer to the appropriate sections of the other stand-alone documents. :) Bryce [EMAIL PROTECTED] wrote on 12/18/2006 03:44:44 PM: > Hey all, > > Anyone's help would, of course, be greatly appreciated on documentation. > Depending on the scale of your involvement, please take the appropriate > approach below. > > If you want to write quick and dirty docs on a piece of the library, > please keep using Confluence. I plan to eventually digest those docs > into the manual. I'm also cataloguing the more interesting emails on the > two lists and hope to use their contents eventually. > > If you want to be involved in writing the whole book, then I'd love to > discuss what common vision we can reach for the user manual. However, > don't start working on the manual unless you really can commit yourself > to serious time to work on it over the next year because the discussion > will take time that I would otherwise prefer to spend elsewhere. Once > I've written the next few chapters, the structure of what I'm doing > should be more obvious to anyone, and it should be easier for you to > jump in. > > In that vein, please consider me the maintainer of the doc/user_manual/ > directory and consult with me before committing into that 'module'. I am > trying to write something fairly complex and carefully crafted so > haphazard additions will cost me extra time to sort out. > > > thanks, > --adrian > > > ------------------------------------------------------------------------- > 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 ------------------------------------------------------------------------- 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
