Update user-replaced value guidance for output (#310)

* Update user-replaced value guidance for output

* Update supplementary_style_guide/style_guidelines/formatting.adoc

Co-authored-by: Andrea Hoffer <[email protected]>

* Updated ambiguity about sample value formatting

* Removed command lines from code blocks

* Matched format of output example to format of code block example

---------

Co-authored-by: Andrea Hoffer <[email protected]>

Author: sbmetz

supplementary_style_guide/style_guidelines/formatting.adoc

@@ -123,6 +123,7 @@ Ensure that user-replaced values have the following characteristics:
 * Lowercase, unless the rest of the related text is uppercase or another capitalization scheme
 * Italicized
 * If the user-replaced value is referencing a value in code or in a command that is normally monospace, also use monospace for the user-replaced value
+* If you want to use a user-replaced value in example output, format the replaceable value with italics and in angle brackets. Alternatively, if you choose to use an example value instead, do not italicize the example value and do not place it in angle brackets.
 
 .Example AsciiDoc: User-replaced value in a paragraph
 
@@ -154,6 +155,28 @@ $ oc describe node __<node_name>__
 ----
 ====
 
+.Example AsciiDoc: User-replaced value in an output example
+
+  [subs="+quotes"]
+  ----
+  connection.id:              __<profile_name>__
+  connection.uuid:            b6cdfa1c-e4ad-46e5-af8b-a75f06b79f76
+  connection.type:            802-3-ethernet
+  connection.interface-name:  enp7s0
+  ----
+
+This renders as:
+
+====
+[subs="+quotes"]
+----
+connection.id:              __<profile_name>__
+connection.uuid:            b6cdfa1c-e4ad-46e5-af8b-a75f06b79f76
+connection.type:            802-3-ethernet
+connection.interface-name:  enp7s0
+----
+====
+
 [[user-replaced-values-xml]]
 == User-replaced values for XML