On Thu, 2005-10-13 at 09:19 -0700, todd runstein wrote:
> if you overwrite the
> online docs everytime the API changes, those who have
> already committed to working with an older version can
> loose their documentation.
>
Yes, so we can
1) have the auto snippet generator add a version stamp and add
docs to the wiki without overwriting previous versions.
Presumably this means there would be a "current cvs" updated
with each build and a "release" version updated, *only when different
from the last release*, for each release. A tough automation job but
doable for a script god.
2) ensure that "releases" have their own docs instead of relying
on the web site exclusively for documentation.
> Putting snippets in the distribution, especially if
> they are accompanied by actual code in .java, .sld,
> .xml, etc. format, the learning curve for newbies
> would be eased. Once someone downloads a
> distribution and starts working with it, having the
> snippets and tutorials on the local machine is more
> convenient than having them online (at least for me -
> I'm still on dialup).
Very much so.
Now let's write some kicka** docs!
--adrian
-------------------------------------------------------
This SF.Net email is sponsored by:
Power Architecture Resource Center: Free content, downloads, discussions,
and more. http://solutions.newsforge.com/ibmarch.tmpl
_______________________________________________
Geotools-gt2-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/geotools-gt2-users
