starlingx/docs
Code Issues Proposed changes

Document hiding empty table rows (r8, r7, r6, r5)

Browse Source 
Add a section to the docs contrib guide explaing usage of empty table row hiding.

Change-Id: I20547b705703d9abde26fa27433409bf14f3f523
Signed-off-by: Ron Stone <ronald.stone@windriver.com>
This commit is contained in:
Ron Stone
2023-11-06 12:52:45 +00:00
parent 47e4b25bef
commit 66c81d4250
1 changed files with 20 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
doc/source/contributor/doc_contribute_guide.rst
View File

@@ -1022,6 +1022,26 @@ The output from ``a.rst`` will include all three definitions. The output from
.. end-conditionalize-content-across-pages
-----------------------
Hiding empty table rows
-----------------------
.. begin-hide-empty-rows
A table may occasionally contain rows with conditionalized content that applies
only in one context, resulting in empty rows in the output from other contexts.
You can supress the output of empty rows by adding ``|hide-empty-rows|`` to the
files in which you want this behavior. All empty rows will be hidden in the
files where you make this addition.
.. note::
If you are also using empty rows as separators between sections in longer
tables, then this behavior may not be what you want.
.. end-hide-empty-rows
-------------------
RST quick reference
-------------------