<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Apr 6, 2015 at 2:57 PM, Meg McRoberts <span dir="ltr"><<a href="mailto:dreidellhasa@yahoo.com" target="_blank">dreidellhasa@yahoo.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div><div style="color:rgb(0,0,0);font-family:HelveticaNeue,'Helvetica Neue',Helvetica,Arial,'Lucida Grande',sans-serif;font-size:12px;background-color:rgb(255,255,255)"><div dir="ltr"><span>Why can't we use the standard Sphinx xref tools for links to this frequently-used information?</span></div><div dir="ltr"><br><span></span></div><div dir="ltr"><span><a href="http://sphinx-doc.org/markup/inline.html" target="_blank">http://sphinx-doc.org/markup/inline.html<br></a></span></div><div>  <br></div><div dir="ltr">It's pretty easy for docs in the same repo.  I've heard that there is a way to implement this for</div><div dir="ltr">docs in different repos but I don't have experience with that.<br></div><div dir="ltr"><br></div></div></div></blockquote><div><br></div><div>We do use :ref: -- see <a href="https://wiki.openstack.org/wiki/Documentation/Markup_conventions#Linking">https://wiki.openstack.org/wiki/Documentation/Markup_conventions#Linking</a></div><div><br></div><div>But the design that we vetted at </div><div><a href="http://openstack-homepage.bitballoon.com/docs/book">http://openstack-homepage.bitballoon.com/docs/book</a><br></div><div><br></div><div>has a "tagging" approach closer to what Andreas is trying to work on.</div><div><br></div><div>I think I misunderstood Karen's question, and jumped to say we don't need "List of Figures" and "List of Tables" such as what we have at the bottom of this page. </div><div><br></div><div><a href="http://docs.openstack.org/juno/install-guide/install/zypper/content/index.html">http://docs.openstack.org/juno/install-guide/install/zypper/content/index.html</a><br></div><div><br></div><div>We don't need List of Figures and List of Tables in our new design. </div><div><br></div><div>Tell me if there's something else you're looking for though. I do recognize that we haven't implemented the dynamic TOC that's shown in the design. We will be able to get there, but for now are ensuring we flip the switch on the migration and iterate on the design as we get more people to try it out. </div><div><br></div><div>Thanks,</div><div>Anne </div><div><br></div><div><br></div></div></div></div>