Merge remote-tracking branch 'upstream/main' into feature/pr-preview-workflows

Author: bburt-rh

supplementary_style_guide/glossary_terms_conventions/general_conventions/k.adoc

@@ -207,6 +207,17 @@ Do not capitalize the first letter.
 
 *See also*:
 
+[[key-pair]]
+==== image:images/yes.png[yes] key pair (noun)
+*Description*: A _key pair_ is a set of two mathematically linked cryptographic keys: a public key that can be shared and a private key that must be kept secret. The public key encrypts data or verifies signatures, and the private key decrypts data or creates signatures. This pairing is the basis of public-key cryptography used in systems like SSH and TLS/SSL.
+
+*Use it*: yes
+
+[.vale-ignore]
+*Incorrect forms*: keypair, Key Pair
+
+*See also*: 
+
 [[keystore]]
 ==== image:images/yes.png[yes] keystore (noun)
 *Description*: A _keystore_ is a repository for private and self-certified security certificates. Write in lowercase as one word. This is in contrast to a "truststore", which stores trusted security certificates.

supplementary_style_guide/style_guidelines/formatting.adoc

@@ -13,22 +13,24 @@ By default, use bold formatting for commands in code blocks to visually distingu
 To apply formatting in a code block, you must use the `quotes` link:https://docs.asciidoctor.org/asciidoc/latest/subs/apply-subs-to-blocks/[AsciiDoc substitution].
 ====
 
-.Example AsciiDoc: A command and its output in separate code blocks
+*Example AsciiDoc: A command and its output in separate code blocks*
 
-  Verify that the `libvirt` default network is active and configured to start automatically:
+[literal]
+--
+Verify that the `libvirt` default network is active and configured to start automatically:
 
-  [subs="+quotes"]
-  ----
-  # *virsh net-list --all*
-  ----
+[subs="+quotes"]
+----
+# *virsh net-list --all*
+----
 
-  [subs="+quotes"]
-  ----
-  Name      State    Autostart   Persistent
-  --------------------------------------------
-  default   active   yes         yes
-  ----
-
+[subs="+quotes"]
+----
+Name      State    Autostart   Persistent
+--------------------------------------------
+default   active   yes         yes
+----
+--
 
 This example renders as follows in HTML:
 

supplementary_style_guide/style_guidelines/release-notes.adoc

@@ -523,7 +523,7 @@ Result:: What happens now that the patch is applied, in the present tense.
 * Use “before this update” instead of “previously” to refer to the past situation. See the xref:previously[previously] glossary entry.
 * Partially fixed issues might require a separate Known issue for the unfixed scenario.
 
-.Example known issue release notes
+.Example fixed issue release notes
 ====
 IPsec `ondemand` connections no longer fail to establish::
 Before this update, when an IPsec connection with the `ondemand` option was configured by using the TCP protocol, the connection failed to establish. With this update, the new Libreswan package makes sure that the initial IKE negotiation completes over TCP. As a result, Libreswan successfully establishes the connection even in TCP mode of IKE negotiation.
@@ -532,7 +532,7 @@ RHEL-51880
 ====
 ====
 Multipath no longer crashes because of errors encountered by the ontap prioritizer::
-Before this update, `multipathd` crashed when it was configured to use the ontap prioritizer on an unsupported path, because the prioritizer only works with NetApp storage arrays. This failure occurred because of a bug in the prioritizer’s error logging code, which caused it to overflow the error message buffer. With this update, the error logging code is fixed, and `multipathd` no longer crashes because of errors encountered by the ontap prioritizer.
+Before this update, `multipathd` failed when it was configured to use the ontap prioritizer on an unsupported path, because the prioritizer only works with NetApp storage arrays. This failure occurred because of a bug in the prioritizer’s error logging code, which caused it to overflow the error message buffer. With this update, the error logging code is fixed, and `multipathd` no longer crashes because of errors encountered by the ontap prioritizer.
 +
 RHEL-49747
 ====