From 8f14c755c4c6fd98ed6511390e6aa05d1fa98e9a Mon Sep 17 00:00:00 2001 From: Ron Stone Date: Thu, 11 Apr 2024 11:15:36 +0000 Subject: [PATCH] Conditionalize content for reuse DS Change-Id: I6c8493c39d5d7a62a61993ce1fd0818d1097fc3d Signed-off-by: Ron Stone --- doc/source/contributor/doc_contribute_guide.rst | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) 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**