<div dir="ltr">Hi all,<div>I've been researching the Sphinx theme approach to get our new web design in place for the content pages themselves. The landing page is complete, using the jinja2 templates. [1] </div><div><br></div><div>I've learned a few things I want to share and these things bring me to look for a slightly different approach than I have in the original blueprint.</div><div><br></div><div><div>The header for <a href="http://www.openstack.org">www.openstack.org</a> has always matched <a href="http://docs.openstack.org">docs.openstack.org</a> and should continue to do so.</div><div><br></div><div>The docs team will likely have to debug any CSS/JS problems with the templates.</div></div><div><br></div><div>Outside of docs, we have <a href="http://ci.openstack.org">ci.openstack.org</a>, <a href="http://specs.openstack.org">specs.openstack.org</a>, and <a href="http://governance.openstack.org">governance.openstack.org</a> using the current oslosphinx theme. They've modified the header in some cases. So there's reasoning to keep the current oslosphinx theme as-is.</div><div><br></div><div>The oslosphinx theme is a theme in itself and it's not straightforward to just add a second extension to it that could be used for <a href="http://docs.openstack.org">docs.openstack.org</a>. Well it's six of one, half dozen of the other, but in discovering there may be a need to keep oslosphinx as-is, and for maintenance, it makes sense to build our own openstack-docs theme in a separate library. </div><div><br></div><div>In the discovery phase, I've put this patch together [2].</div><div><br></div><div>In looking at all the overlap between the jinja2 templates and CSS, it is definitely more efficient to try to maintain all those files together. I think a separate repo is the way to go.</div><div><br></div><div>Does that sound okay to you all? Please reply here and/or vote on [3].</div><div><br></div><div>Thanks,</div><div>Anne<br><br></div><div>1. <a href="https://review.openstack.org/#/c/142369/">https://review.openstack.org/#/c/142369/</a></div><div>2. <a href="https://review.openstack.org/#/c/148072/">https://review.openstack.org/#/c/148072/</a><br clear="all"><div><div>3. <a href="https://review.openstack.org/#/c/147646/">https://review.openstack.org/#/c/147646/</a></div></div>-- <br><div class="gmail_signature">Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div></div></div>