add recommendation to specify font-size of literal as a relative value [skip ci]

1 files changed, 5 insertions, 2 deletions

diff --git a/docs/theming-guide.adoc b/docs/theming-guide.adoc
index 3a41b6b9..f9a8bc7c 100644
--- a/docs/theming-guide.adoc
+++ b/docs/theming-guide.adoc
@@ -1698,11 +1698,11 @@ The keys in this category are used for inline monospaced text in prose and table
 |literal:
   font-family: M+ 1mn
 
-|font-size
+|font-size^[3]^
 |<<values,Number>> +
 (default: _inherit_)
 |literal:
-  font-size: 12
+  font-size: 1.15em
 
 |font-style
 |<<font-styles,Font style>> +
@@ -1716,6 +1716,9 @@ The border only works properly if the literal phrase does not have nested format
 Otherwise, the border will be inherited, producing a less than desirable result.
 2. The border offset is the amount that the background and border swells around the text.
 It does not affect the distance between the formatted phrase and the phrases that surround it.
+3. If you set the font-size property on a code span, you're strongly encouraged to specify it as a relative font size using `em` units (e.g., `0.9em`).
+A code span with a fixed font size will not be scaled when the font size of the parent element (e.g., table, caption, etc) is specified.
+However, by using a relative value, the font size will be computed relative to the size of the text that surrounds it, giving you effectively the same result.
 
 [#keys-heading]
 === Heading