Switch to unstable sphinx-argparse for better documentation section numbers

ssec / polar2grid

Tools for reading, remapping, and writing satellite instrument data.

http://www.ssec.wisc.edu/software/polar2grid/

GNU General Public License v3.0

72 stars 34 forks source link

Switch to unstable sphinx-argparse for better documentation section numbers #676

Closed djhoese closed 8 months ago

djhoese commented 8 months ago

Sphinx-argparse is a third-party tool used to put our command line arguments from the python code into our documentation in a pretty way. It currently has a bug where section numbers are not kept unique between argparse blocks in a single page/document of the documentation. This PR updates Polar2Grid's build steps to use my not-yet-merged pull request code to sphinx-argparse where this is fixed (or at least worked around).

Closes #289

coveralls commented 8 months ago

coverage: 85.333%. remained the same when pulling ca490b46520b99fb0a134f92adbb0fcb7a1725b4 on djhoese:bugfix-sphinx-argparse-secton-nums into be6bc9c9a772bb95ac8004ab2846087a34bb8401 on ssec:main.