Vamp up typography!

Author: Lennonka

guides/common/attributes-typography.adoc

@@ -0,0 +1,10 @@
+// Extra attributes for typography
+// See also: https://docs.asciidoctor.org/asciidoc/latest/attributes/character-replacement-ref/
+
+// CHARACTERS
+:endash: –
+:hairspace:  
+
+// MORE COMPLEX STUFF
+// Number ranges, e.g. "10{range}20" instead of "10 - 20"
+:range: {hairspace}{endash}{hairspace}

guides/common/attributes.adoc

@@ -18,14 +18,19 @@
 //
 // WHERE ARE MY ATTRIBUTES?
 //
-// All attributes were moved into separate files:
-// * attributes-base.adoc (upstream attributes common for all builds)
+// Attributes are split into separate files
+// Attribute files COMMON for all builds:
+// * attributes-base.adoc (basic upstream attributes)
+// * attributes-titles-base.adoc (title attributes)
+// * attributes-typography.adoc (extra typographical attributes)
+// Attribute files for SPECIFIC PRODUCTS:
 // * attributes-foreman-el.adoc (attributes overridden or unique to Red Hat Enterprise Linux and clones)
 // * attributes-foreman-deb.adoc (attributes overridden or unique to Debian/Ubuntu)
 // * attributes-katello.adoc (attributes overridden or unique to Katello)
+// * attributes-orcharhino.adoc (attributes overridden or unique to orcharhino)
 // * attributes-satellite.adoc (attributes overridden or unique to Satellite)
 
-// Define properties to represent each build. Allows doing 'or' and 'and' operations for conditions.
+// Define properties to represent each build. Allows 'or' and 'and' operations in conditions.
 ifeval::["{build}" == "foreman-el"]
 :foreman-el:
 :foreman:
@@ -50,6 +55,7 @@ endif::[]
 :SiteURL: https://docs.theforeman.org
 :BaseURL:  {SiteURL}/{ProjectVersion}/
 include::attributes-base.adoc[]
+include::attributes-typography.adoc[]
 
 // Load overrides for specific scenarios
 ifdef::foreman-el[]

guides/doc-Upgrading_and_Updating/topics/upgrading_process_overview.adoc

@@ -36,13 +36,12 @@ Before proceeding, complete the following:
 * Review this guide so that you are aware of the upgrade process and its impact.
 * Plan your upgrade path.
 For more information, see xref:upgrade_paths[].
-
 * Plan for the required downtime. {Project} services are shut down during the upgrade.
 The upgrade process duration might vary depending on your hardware configuration, network speed, and the amount of data that is stored on the server.
 +
-Upgrading {Project} takes approximately 1 - 2 hours.
+Upgrading {Project} takes approximately 1{range}2 hours.
 +
-Upgrading {SmartProxy} takes approximately 10 - 30 minutes.
+Upgrading {SmartProxy} takes approximately 10{range}30 minutes.
 
 * Ensure that you have sufficient storage space on your server.
 For more information, see {InstallingProjectDocURL}Preparing_your_Environment_for_Installation_{project-context}[Preparing your Environment for Installation] in _Installing {ProjectServer} from a Connected Network_ and {InstallingSmartProxyDocURL}preparing-environment-for-capsule-installation[Preparing your Environment for Installation] in _Installing {SmartProxyServer}_.