gdal icon indicating copy to clipboard operation
gdal copied to clipboard

Removing duplication between doc/source/api/python_bindings.rst and swig/python/README.rst ?

Open rouault opened this issue 2 years ago • 3 comments

From https://github.com/OSGeo/gdal/pull/6110#issuecomment-1206426874 """ Looks like https://github.com/OSGeo/gdal/blob/master/doc/source/api/python_bindings.rst is a duplicate of the swig/Python readme. Thoughts about replacing its contents with something like .. include:: ../../../swig/python/README.rst? """

The content is not exactly the same, and there might be issues with links/cross-reference. To be investigated

rouault avatar Aug 05 '22 16:08 rouault

An alternative would be to go the other direction and reference the python bindings (https://gdal.org/api/python_bindings.html) in the swig/python/README.rst.

snowman2 avatar Aug 07 '22 01:08 snowman2

An alternative would be to go the other direction and reference the python bindings (https://gdal.org/api/python_bindings.html) in the swig/python/README.rst.

you meant having a mostly empty swig/python/README.rst just linking to the https://gdal.org/api/python_bindings.html URL ?

rouault avatar Aug 09 '22 17:08 rouault

you meant having a mostly empty swig/python/README.rst just linking to the https://gdal.org/api/python_bindings.html URL ?

Yeah, something like that.

snowman2 avatar Aug 09 '22 17:08 snowman2