[doc] question/enhancement-request on Sphinx theme used by openstack docs

Waines, Greg Greg.Waines at windriver.com
Fri Jun 10 12:30:23 UTC 2022

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,


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

More information about the openstack-discuss mailing list