diff --git a/doc/source/contributor/doc_contribute_guide.rst b/doc/source/contributor/doc_contribute_guide.rst index 1fbeaa2d2..fec3316eb 100644 --- a/doc/source/contributor/doc_contribute_guide.rst +++ b/doc/source/contributor/doc_contribute_guide.rst @@ -396,19 +396,24 @@ the file name/label string like this: ``architectural-considerations--d9dd4c105 Using tabbed content -------------------- -.. begin-using-tabbed-content - Content on the master branch can take advantage of the ``sphinx-tabs`` extension to organize content into tabs. + +.. begin-using-tabbed-content + + Tabs are useful for presenting alternate sets of content in a way that does not require that the reader interact with sets that are not of interest. This is particularly useful in procedures where some steps vary across two or more variable factors. Rather than maintain two or more seperate procedures, tabs can be used to show one of the alternate sets of content. For example, the -installation procedures make heavy use of tabs to allow the reader to switch -between virtual and bare-metal versions of the procedures. See -:ref:`aio_simplex_install_kubernetes_r7` for an example. +|prod| installation procedures make heavy use of tabs to allow the reader to +switch between virtual and bare-metal versions of the procedures. + +.. only:: starlingx + + See :ref:`aio_simplex_install_kubernetes_r7` for an example. **Basic tabs**