Open Stack

Hey ... I am on the technical steering committee for the openstack starlingx team and also provide primary technical review for our docs at https://docs.starlingx.io/ .

docs.starlingx.io basically uses the openstack docs team's Sphinx theme for building our html docs ... see https://opendev.org/starlingx/docs .

docs.starlingx.io is a very large doc suite.

We are interested in improvements to the Table-of-Contents (TOC) navigation and presentation ... but we have limited Sphinx expertise.

Specifically we are looking for the TOC support to have

- more subsection header levels in TOC

         // such that user has full view of where he currently is in the doc hierarchy

- highlighting to indicate currently selected section

- separate scroll bar for TOC

         // ... so you don't lose sight of selected TOC selection when you scroll down on the main page which has large content.



Have you ever considered such doc improvements?

Did you have Sphinx expertise to do such improvements ?



let us know,

Greg.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-discuss/attachments/20220610/70be98a2/attachment-0001.htm>