How to add a new folder to ReadTheDocs

  1. Find the nearest index.rst in the parents of the folder.

  2. Add the following code block at the intended TOC location:

.. toctree::
   :glob:
   :titlesonly:
   :caption: $CAPTION

   ./$FOLDER/*

where $CAPTION is effectively the folder name in normal English and $FOLDER is the new folder to add.

  1. If the folder is of the form $a/$b/.../$c and it should be added to $a/index.rst, the last line should be ./$b/** instead. This change includes all subdirectories as well and is hence more useful in this case.