From fc9926a5ac79009841d4ee36387c9b5c98462a06 Mon Sep 17 00:00:00 2001
From: andymunro <48995441+andymunro@users.noreply.github.com>
Date: Wed, 10 Nov 2021 05:35:52 -0500
Subject: [PATCH] Addressing review comments (#1211)

---
 release_notes/topics/product/7_4_final.adoc   | 25 +++++++++++++++----
 .../document-attributes-product.adoc          |  2 +-
 2 files changed, 21 insertions(+), 6 deletions(-)

diff --git a/release_notes/topics/product/7_4_final.adoc b/release_notes/topics/product/7_4_final.adoc
index 5ac9eb59ed..d8ea3068ed 100644
--- a/release_notes/topics/product/7_4_final.adoc
+++ b/release_notes/topics/product/7_4_final.adoc
@@ -35,7 +35,10 @@ RH-SSO offers the possibility to add conditions at specific places of the authen
 
 Adding conditional authenticators allowed us to remove the OPTIONAL requirement for the authentication executions. Conditional authenticators are more flexible and allow for support of everything that was previously allowed with the OPTIONAL authentication execution requirement. If you use the OPTIONAL authentication execution, your authentication flows are migrated automatically.
 
-See the link:{upgradingguide_link}[{upgradingguide_name}] for more details.
+[role="_additional-resources"]
+.Additional resources
+
+* link:{upgradingguide_link}[{upgradingguide_name}]
 
 === Credentials management
 
@@ -47,7 +50,9 @@ Administrators can see all credentials of a particular user and some public meta
 
 Users can see all their credentials in the Account Console and add or delete credentials. See the section on the New Account Console, which is a Technology Preview feature. The currently supported account console, the User Account Service, does not support this feature. It supports OTP in a similar way to the previous RH-SSO version.
 
-See link:{adminguide_authentication_flow_link}[{adminguide_authentication_flow_name}] in the link:{adminguide_link}[{adminguide_name}] for more details.
+[role="_additional-resources"]
+.Additional resources
+* link:{adminguide_authentication_flow_link}[Server Administration Guide]
 
 == Vaults for secrets
 
@@ -71,7 +76,10 @@ RH-SSO includes a new built-in vault provider that reads secrets from a keystore
 
 A vault SPI has been introduced to enable development of extensions to access secrets from custom vaults.
 
-See the link:{adminguide_link}[{adminguide_name}] and the link:{developerguide_link}[{developerguide_name}] for more details.
+[role="_additional-resources"]
+.Additional resources
+* link:{adminguide_link}[{adminguide_name}]
+* link:{developerguide_link}[{developerguide_name}]
 
 == WebAuthn (Preview)
 
@@ -100,9 +108,16 @@ standalone -Dkeycloak.profile.feature.account_api=enabled -Dkeycloak.profile.fea
 
 When you go to Manage Account, you will see the new Account Console.  Here is a sample screen:
 
-image:{project_images}/device-activity.png[]
+.Device activity
+image:{project_images}/device-activity.png[Device activity]
 
-This new console is based on link:https://reactjs.org/[React] and link:https://www.patternfly.org/v4/[PatternFly 4].  It allows you to use link:https://www.patternfly.org/v4/developer-resources/global-css-variables/#global-variables[PatternFly CSS variables] for easy styling.  It also allows you to remove pages and add your own pages.  Full documentation will be provided at a future release.
+This new console is based on React and PatternFly 4.  It allows you to use PatternFly CSS variables for easy styling.  It also allows you to remove pages and add your own pages.  Full documentation will be provided at a future release.
+
+.Additional resources
+[role="_additional-resources"]
+* link:https://reactjs.org/[React]
+* link:https://www.patternfly.org/v4/[PatternFly 4]
+* link:https://www.patternfly.org/v4/developer-resources/global-css-variables/#global-variables[PatternFly CSS variables]
 
 == New default hostname provider
 
diff --git a/topics/templates/document-attributes-product.adoc b/topics/templates/document-attributes-product.adoc
index 8ff4515689..3564e08027 100644
--- a/topics/templates/document-attributes-product.adoc
+++ b/topics/templates/document-attributes-product.adoc
@@ -45,7 +45,7 @@
 :adminguide_name: Server Administration Guide
 :adminguide_link: {project_doc_base_url}/server_administration_guide/
 :adminguide_authentication_flow_name: authentication flow
-:adminguide_authentication_flow_link: {adminguide_link}#_authentication-flows
+:adminguide_authentication_flow_link: {adminguide_link}#authentication-flows
 :adminguide_bruteforce_name: Password guess: brute force attacks
 :adminguide_bruteforce_link: {adminguide_link}#password-guess-brute-force-attacks
 :adminguide_disabling_automatic_user_creation_name: disabling automatic user creation