<div dir="ltr">Hi! <div><br></div><div>Recently I've noticed that the h1 text on the manila API ref no longer shows up in the main text body, though it is still listed in the navigation bar on the left hand side. <div>I've noticed a similar issue on the Ironic, Nova, Neutron API guides as well. </div><div>I think the change you mentioned caused this, though I'm not completely sure since not all API guides are affected. </div><div>For example, Swift's API guide still works as expected with visible header 1s identifying the resource, and each method being listed in the nav bar as well.</div><div>Cinder's API guide makes use of h2 instead, and thus doesn't have each method listed in the nav bar, though the titles are visible. </div><div>What I'd like to see in the manila API guide is each resource shown as h1 both in the main body and in the navigation bar, along with each corresponding method. </div><div>If I were to change the resource titles to h2 I would be able to see the title itself but lose the methods in the nav bar, and yet keeping them as h1 means the side bar works but the main text is missing titles. </div><div>I don't have much experience with front-end work so I'd really appreciate any guidance you can offer to fix this. </div><div><br></div><div>Thanks,</div><div>Ashley</div></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Aug 10, 2021 at 8:05 PM Peter Matulis <<a href="mailto:peter.matulis@canonical.com">peter.matulis@canonical.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div>I'm now seeing this symptom on several projects in the 'latest' release branch. Such as:</div><div><br></div><div><a href="https://docs.openstack.org/nova/latest/" target="_blank">https://docs.openstack.org/nova/latest/</a><br></div><div><br></div><div>My browser exposes the following error:</div><div><br></div><div><img src="cid:ii_ks6q2laz0" alt="image.png" width="550" height="42"><br></div><div><br></div><div>We patched [1] our project as a workaround.</div><div><br></div><div>Could one of Stephen's commits [2] be involved?</div><div><br></div><div>[1]: <a href="https://review.opendev.org/c/openstack/charm-deployment-guide/+/803531" target="_blank">https://review.opendev.org/c/openstack/charm-deployment-guide/+/803531</a><br></div>[2]: <a href="https://opendev.org/openstack/openstackdocstheme/commit/08461c5311aa692088a27eb40a87965fd8515aba" target="_blank">https://opendev.org/openstack/openstackdocstheme/commit/08461c5311aa692088a27eb40a87965fd8515aba</a></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Jun 10, 2021 at 3:51 PM Peter Matulis <<a href="mailto:peter.matulis@canonical.com" target="_blank">peter.matulis@canonical.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Hi Stephen. Did you ever get to circle back to this?</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, May 14, 2021 at 7:34 AM Stephen Finucane <<a href="mailto:stephenfin@redhat.com" target="_blank">stephenfin@redhat.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div><div>On Tue, 2021-05-11 at 11:14 -0400, Peter Matulis wrote:</div><blockquote type="cite" style="margin:0px 0px 0px 0.8ex;border-left:2px solid rgb(114,159,207);padding-left:1ex"><div dir="ltr"><div>Hi, I'm hitting an oddity in one of my projects where the titles of all pages show up twice.</div><div> </div><div>Example:</div><div><br></div><a href="https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/wallaby/app-nova-cells.html" target="_blank">https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/wallaby/app-nova-cells.html</a><br><div><br></div><div>Source file is here:</div><div><br></div><div><a href="https://opendev.org/openstack/charm-deployment-guide/src/branch/master/deploy-guide/source/app-nova-cells.rst" target="_blank">https://opendev.org/openstack/charm-deployment-guide/src/branch/master/deploy-guide/source/app-nova-cells.rst</a><br></div><div><br></div><div>Does anyone see what can be causing this? It appears to happen only for the current stable release ('wallaby') and 'latest'.</div><div><br></div><div>Thanks,</div><div>Peter</div></div></blockquote><div><br></div><div>I suspect you're bumping into issues introduced by a new version of Sphinx or docutils (new versions of both were released recently).</div><div><br></div><div>Comparing the current nova docs [1] to what you have, I see the duplicate <h1> element is present but hidden by the following CSS rule:</div><div><br></div><pre style="margin-left:3ch">.docs-body .section h1 {</pre><pre style="margin-left:3ch">    display: none;</pre><pre style="margin-left:3ch">}</pre><div><br></div><div>That works because we have the following HTML in the nova docs:</div><div><br></div><pre style="margin-left:3ch"><div class="section" id="extra-specs"></pre><pre style="margin-left:3ch">    <h1>Extra Specs<a class="headerlink" href="#extra-specs" title="Permalink to this headline">¶</a></h1></pre><pre style="margin-left:3ch">    ...</pre><pre style="margin-left:3ch"></div></pre><div><br></div><div>while the docs you linked are using the HTML5 semantic '<section>' tag:</div><div><br></div><pre style="margin-left:3ch"><section id="nova-cells"></pre><pre style="margin-left:3ch">    <h1>Nova Cells<a class="headerlink" href="#nova-cells" title="Permalink to this headline">¶</a></h1></pre><pre style="margin-left:3ch">    ...</pre><pre style="margin-left:3ch"></section></pre><div><br></div><div>So to fix this, we'll have to update the openstackdocstheme to handle these changes. I can try to take a look at this next week but I really wouldn't mind if someone beat me to it.</div><div><br></div><div>Stephen</div><div><br></div><div>[1] <a href="https://docs.openstack.org/nova/latest/configuration/extra-specs.html" target="_blank">https://docs.openstack.org/nova/latest/configuration/extra-specs.html</a></div><div><span></span></div></div>
</blockquote></div>
</blockquote></div>
</blockquote></div>