On Mon, Apr 6, 2015 at 2:57 PM, Meg McRoberts <dreidellhasa at yahoo.com> wrote: > Why can't we use the standard Sphinx xref tools for links to this > frequently-used information? > > http://sphinx-doc.org/markup/inline.html > > It's pretty easy for docs in the same repo. I've heard that there is a > way to implement this for > docs in different repos but I don't have experience with that. > > We do use :ref: -- see https://wiki.openstack.org/wiki/Documentation/Markup_conventions#Linking But the design that we vetted at http://openstack-homepage.bitballoon.com/docs/book has a "tagging" approach closer to what Andreas is trying to work on. 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. http://docs.openstack.org/juno/install-guide/install/zypper/content/index.html We don't need List of Figures and List of Tables in our new design. 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. Thanks, Anne -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20150406/1ff07752/attachment-0001.html>