[gdal-dev] [SeasonOfDocs] Offers for GDAL documenting
eadam at co.lincoln.or.us
Mon Jun 17 08:16:30 PDT 2019
On Mon, Jun 17, 2019 at 5:43 AM Even Rouault <even.rouault at spatialys.com> wrote:
> this is really great news ! Given my experience with the project, I'm rather
> far from being representative of someone less familiar with it or with a non-
> developer profile, so thoughts from the broader GDAL community on what they
> feel is the most missing would be welcome.
There are some things that are very basic that might make the
documentation more understandable to a beginner. I'm not sure if
these things are true or I've made them up or they are supposed to be
too obvious to state.
-nln = New Layer Name
-nlt = New Layer Type
-a_srs = assign spatial reference system
-t_srs = target spatial reference system
-s_srs = source spatial reference system
-ot = output type
-of = output format
Are those true? If not, I've used them to better understand (and
remember) the options.
Best regards, Eli
> One thing I've in mind - this is rather a detail - is that we lost a bit of
> content (build requirements for each driver) during the Sphinx migration, as
> pointed out by
> https://github.com/OSGeo/gdal/issues/1204#issuecomment-498624481 , so this
> could be a potential task.
> More generally, I feel we might need more tutorial-like / how-to style
> documentation. The current documentation is hopefully rather decent as a
> reference guide, but lacking on the quick-start side. On the wiki, there are
> some source of information, mostly from
> https://trac.osgeo.org/gdal/wiki/UserDocs , that could be interesting to
> migrate partly on the main documentation, but with a critical eye (some of the
> hints might be outdated due to later improvements, etc)
> Lynden, perhaps you've also suggestions from your practice of the project and
> its documentation on what you'd like to see added ?
> Spatialys - Geospatial professional services
> gdal-dev mailing list
> gdal-dev at lists.osgeo.org
More information about the gdal-dev