Skip to content

Commit 7381dd1

Browse files
soften table guidelines
1 parent 4a79db5 commit 7381dd1

File tree

1 file changed

+8
-5
lines changed

1 file changed

+8
-5
lines changed

docs/contribute/cumulative-docs/badge-placement.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -127,16 +127,19 @@ For example, the [Streaming Input](https://www.elastic.co/docs/reference/beats/f
127127
:alt:
128128
::::
129129

130-
:::{warning}
131-
Do **not** create a new column just for versions.
132-
The `applies_to` badges should _not_ require contributors to add specific Markdown real estate to the page layout.
133-
Instead, contributors should be able to add them anywhere they need, and the system should be in charge of rendering them clearly.
130+
In some cases it might be appropriate to add column dedicated to applicability,
131+
but you should avoid adding specific Markdown real estate to the page layout and
132+
causing existing tables with content from long before the base version,
133+
for example Elastic Stack 9.0.0, look incomplete.
134+
135+
In the same example as above, creating a column dedicated to applicability would
136+
likely take up unnecessary space and could cause confusion since the majority of
137+
rows include content that has been available long before 9.0.0.
134138

135139
::::{image} ./images/table-entire-row-incorrect.png
136140
:screenshot:
137141
:alt:
138142
::::
139-
:::
140143

141144
#### If the badge is relevant to one cell, add the badge to the cell it applies to [table-cell]
142145

0 commit comments

Comments
 (0)