documentation icon indicating copy to clipboard operation
documentation copied to clipboard

The index file in a Sphinx project should not be .rst

Open bast opened this issue 2 years ago • 2 comments

See the index file for this lesson: https://github.com/coderefinery/documentation/pull/284

bast avatar Oct 02 '23 16:10 bast

It will be simpler to introduce Sphinx with "pure" md (as interpreted by MyST) instead of using md everywhere except for the index file.

bast avatar Oct 02 '23 16:10 bast

One complication is that sphinx-quickstart always generates an index.rst and we would have to change it to index.md afterwards.

bast avatar Mar 24 '24 13:03 bast