Hello, It certainly is true that a lot less work is put into the docs than into the code. This is a syndrome that affects most projects and the root cause is that good docs take a long time to write, test and edit but generally nobody wants to fund this work. As a result pretty much all of the effort that goes into the GeoTools docs is done in the developers' sparse free time.
This isn't to argue against your observations - simply to point out that the lack of complete, consistent, quality documentation doesn't mean we just forgot about it :-) On the user list we regularly ask people for feedback and contributions to the wiki and web examples. But it's usually a lot easier to get code contributions than it is to get help with the docs. Michael On 7 May 2010 10:19, Rodrigo <rodrigoh...@gmail.com> wrote: > > Brian Ghigiarelli, > > > I'm also finding it very difficult to learn GeoTools. The API is not > easy and the documentation is incomplete and confusing. > > To create a single point on the map with an icon is very complex! As a > user will be able to learn alone without good documentation it needs to > use GeometryFactory, SimpleFeatureBuilder, DataUtilities, SimpleFeature, > FeatureCollection to create a point. Not to mention the complexity to > create a style to the point! > > To show this simple point remains: an object MapLayer and add it to an > object MapContext? I spent days to understand how to create and display > a point! > > Because so many objects to create a point on the map? I do not understand. > > I would not say it, but I'm also searching other libraries for GIS. I'm > still trying to use GeoTools in my application, but do not want to spend > several months to make things simple. I have deadlines to deliver the > results of my work! > > I know GeoTools developers had much work to get here, but I hope that my > criticisms are meant as an alert. > > > Sincerely, > > > Rodrigo > > > > Em 06-05-2010 13:06, Jody Garnett escreveu: >> Brian Ghigiarelli > > ------------------------------------------------------------------------------ > > _______________________________________________ > Geotools-gt2-users mailing list > Geotools-gt2-users@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/geotools-gt2-users > ------------------------------------------------------------------------------ _______________________________________________ Geotools-gt2-users mailing list Geotools-gt2-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geotools-gt2-users
