<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Hi,<div class=""><br class=""></div><div class="">Not in any way an advertisement, but we quite heavily reworked openstackdocstheme for our cloud (<a href="https://github.com/opentelekomcloud/otcdocstheme" class="">https://github.com/opentelekomcloud/otcdocstheme</a> => <a href="https://docs-beta.otc.t-systems.com/otcdocstheme/" class="">https://docs-beta.otc.t-systems.com/otcdocstheme/</a>). We have updated to the latest bootstrap, fixed some of the layout issues, added right sidebar with local top and some other tunings. Our there is surely not to be reused by anybody else, but it may give you some hints what can be improved.</div><div class=""><br class=""></div><div class="">Regards,</div><div class="">Artem<br class=""><div><br class=""><blockquote type="cite" class=""><div class="">On 10. Jun 2022, at 14:30, Waines, Greg <<a href="mailto:Greg.Waines@windriver.com" class="">Greg.Waines@windriver.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><meta charset="UTF-8" class=""><div class="WordSection1" style="page: WordSection1; caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class="">Hey … I am on the technical steering committee for the openstack starlingx team and also provide primary technical review for our docs at<span class="Apple-converted-space"> </span><a href="https://docs.starlingx.io/" style="color: rgb(5, 99, 193); text-decoration: underline;" class="">https://docs.starlingx.io/</a><span class="Apple-converted-space"> </span>.<o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><o:p class=""> </o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><a href="http://docs.starlingx.io/" style="color: rgb(5, 99, 193); text-decoration: underline;" class="">docs.starlingx.io</a><span class="Apple-converted-space"> </span>basically uses the openstack docs team’s Sphinx theme for building our html docs … see<a href="https://opendev.org/starlingx/docs" style="color: rgb(5, 99, 193); text-decoration: underline;" class="">https://opendev.org/starlingx/docs</a><span class="Apple-converted-space"> </span>.<o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><o:p class=""> </o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><a href="http://docs.starlingx.io/" style="color: rgb(5, 99, 193); text-decoration: underline;" class="">docs.starlingx.io</a><span class="Apple-converted-space"> </span>is a very large doc suite.<o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><o:p class=""> </o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class="">We are interested in improvements to the Table-of-Contents (TOC) navigation and presentation … but we have limited Sphinx expertise.<o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><o:p class=""> </o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class="">Specifically we are looking for the TOC support to have<o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class="">- more subsection header levels in TOC<o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class=""> // such that user has full view of where he currently is in the doc hierarchy<o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class="">- highlighting to indicate currently selected section<o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class="">- separate scroll bar for TOC<span class="Apple-converted-space"> </span><o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class=""> // ... so you don't lose sight of selected TOC selection when you scroll down on the main page which has large content.<o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><o:p class=""> </o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class="">Have you ever considered such doc improvements?<o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class="">Did you have Sphinx expertise to do such improvements ?<o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><o:p class=""> </o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class="">let us know,<o:p class=""></o:p></div><div style="margin: 0in; font-size: 11pt; font-family: Calibri, sans-serif;" class="">Greg.</div></div></div></blockquote></div><br class=""></div></body></html>