Hey Martin thanks for the feedback. With respect to most recent javadocs / intros etc feedback is the benefit the user list provides the developers. Sheltering on the stable branch does not offer the same reward. In short if you want developers to write docs we are only going to be able to motivate them to write docs for the most recent version.
That said we should be able to make the old docs available for download; I will experiment with making a doc download when I release GeoTools next week. For repositories it is a bit more tricky. Part of the thing is that it is impolite to turn repositories off - since older projects will still build against them and we get very much yelled at for breaking other people's builds. The other complicating factor is that the "stable" repository hosted at osgeo.org has not been stable in terms of the server being up. Still I think there is a good solution: get geotools into root maven repositories; geoserver manages to get in because they publish to codehaus which synchronises with the root maven repositories. This way we would only advertise one repository for SNAPSHOTs and advise people to use their local maven mirror for stable releases. Jody On 07/05/2010, at 5:10 PM, Martin Tomko wrote: > Hi Jodi, all, > I just noticed this thread and wanted to comment. > > First, I think that the default javadoc presented should be the latest > stable branch.My understanding is that 2.7 is still not a stable > release, and I would prefer not to be lured into it until stable, and I > assume others may feel similar. It confuses ordinary users that do not > follow the development on a daily basis. > > I would also prefer if the version number appeared in the url, it would > make it easy to navigate between versions, somethign i used quite a few > times with other projects to compare. > > Finally, there seems to be a huge number of various geotools > repositories, and if one only searches for it on the web and does not > naviagte from the geotools.org website, it is easy to end up there, > without knowing how recent the javadocs are. These are the ones hosted > on codehouse, on http://javadoc.geotools.fr/, and similar. If any of > these are within reach of the community and not actively synchronized, I > would advocate removing them. > > My 2 cents, > M. > > ------------------------------------------------------------------------------ > > _______________________________________________ > Geotools-gt2-users mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/geotools-gt2-users ------------------------------------------------------------------------------ _______________________________________________ Geotools-gt2-users mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/geotools-gt2-users
