OSGeo
Doc: Condense tutorial presentation
Feature description
The tutorials (e.g., Raster API tutorial provide example code in C, C++, and Python. The presentation of this code could be condensed using something like sphinx-tabs.
Additional context
No response
@dbaston - I've been testing the sphinx-tabs plugin and it works very well on that Raster API tutorial. Could you assign this issue to me?
Other candidates for use of sphinx-tabs are:
- https://gdal.org/en/stable/tutorials/index.html
- https://gdal.org/en/stable/tutorials/osr_api_tut.html#alternate-interfaces
Sometimes the driver examples (and command line programs) don't work under Windows due to different quote-escaping etc. so tabs could also be useful in these cases e.g. https://gdal.org/en/stable/drivers/raster/stacit.html#examples
@dbaston @rouault - I'm currently moving the other tutorials to tabs.
Quick question - in the Vector tutorial https://gdal.org/en/stable/tutorials/vector_api_tut.html#reading-from-ogr there are examples for both "With GDAL 2.3 and C++11" and "With GDAL < 2.3 and C++" (as well as C). Should the GDAL < 2.3 examples still be kept? If so, I can add them to another tab, but maybe they should be removed altogether from the latest docs?
Should the GDAL < 2.3 examples still be kept?
I think they should be removed.
I think they should be removed.
mentions of anything older than 3.0 can be removed
All tutorials with code example in several languages have been updated to use tabs. Closing.