[RHIDP-12906]: Audit and fix book-link/book-title attributes (#1961)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: themr0c

artifacts/attributes.adoc

@@ -115,8 +115,8 @@
 // Links and their title (in alphabetical order)
 :about-book-link: {product-docs-link}/html-single/about_red_hat_developer_hub/index
 :about-book-title: About {product}
-:adoption-insights-link: {product-docs-link}/html-single/adoption_insights_in_red_hat_developer_hub/index
-:adoption-insights-title: Adoption Insights in {product}
+:adoption-insights-book-link: {product-docs-link}/html-single/adoption_insights_in_red_hat_developer_hub/index
+:adoption-insights-book-title: Adoption Insights in {product}
 :ansible-automation-platform-docs-link: link:https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/{ansible-automation-platform-version}
 :audit-log-book-link: {product-docs-link}/html-single/audit_logs_in_red_hat_developer_hub/index
 :audit-log-book-title: Audit logs in {product}
@@ -133,14 +133,15 @@
 :customizing-book-link: {product-docs-link}/html-single/customizing_red_hat_developer_hub/index
 :customizing-book-title: Customizing {product}
 :default-helm-chart-values-link: link:https://github.com/redhat-developer/rhdh-chart/blob/release-{product-version}/charts/backstage/values.yaml
-:developer-lightspeed-link: {product-docs-link}/html-single/interacting_with_red_hat_developer_lightspeed_for_red_hat_developer_hub/index
+:develop-and-deploy-dynamic-plugins-book-link: {product-docs-link}/html-single/develop_and_deploy_dynamic_plugins_in_red_hat_developer_hub/index
+:develop-and-deploy-dynamic-plugins-book-title: Develop and deploy dynamic plugins in {product}
+:developer-lightspeed-book-link: {product-docs-link}/html-single/interacting_with_red_hat_developer_lightspeed_for_red_hat_developer_hub/index
+:developer-lightspeed-book-title: Interacting with {ls-brand-name}
 :discover-category-link: {product-docs-link}/#Discover
 :dynamic-plugins-default-yaml-link: link:https://github.com/redhat-developer/rhdh/blob/release-{product-version}/dynamic-plugins.default.yaml
 :dynamic-plugins-reference-book-link: {product-docs-link}/html-single/dynamic_plugins_reference/index
 :dynamic-plugins-reference-book-title: Dynamic plugins reference
 :extend-category-link: {product-docs-link}/#Extend
-:getting-started-on-ocp-for-the-platform-engineer-book-link: {product-docs-link}/html-single/getting_started_with_red_hat_developer_hub_on_red_hat_openshift_container_platform_for_the_platform_engineer/index
-:getting-started-on-ocp-for-the-platform-engineer-book-title: Getting started with {product} on {ocp-brand-name} for the platform engineer
 :install-category-link: {product-docs-link}/#Install
 :installing-and-viewing-plugins-book-link: {product-docs-link}/html-single/installing_and_viewing_plugins_in_red_hat_developer_hub/index
 :installing-and-viewing-plugins-book-title: Installing and viewing plugins in {product}
@@ -156,23 +157,22 @@
 :installing-on-ocp-book-title: Installing {product} on {ocp-short}
 :installing-on-osd-on-gcp-book-link: {product-docs-link}/html-single/installing_red_hat_developer_hub_on_openshift_dedicated_on_google_cloud/index
 :installing-on-osd-on-gcp-book-title: Installing {product} on {gcp-brand-name} on {gcp-brand-name}
-:installing-rhdh-orch-on-ocp-book-link: {product-docs-link}/html-single/installing_rhdh_with_orchestrator_plugin_on_{ocp-short}_using_operator_in_an_air-gapped_environment/index
-:installing-rhdh-orch-on-ocp-book-title: Installing RHDH with the Orchestrator Plugin on {ocp-short} using the {product} Operator
 :integrating-with-github-book-link: {product-docs-link}/html-single/integrating_red_hat_developer_hub_with_github/index
 :integrating-with-github-book-title: Integrating {product} with GitHub
 :learning-path-data-json-link: link:https://raw.githubusercontent.com/redhat-developer/rhdh/release-{product-version}/packages/app/public/learning-paths/data.json
-:manage-and-consume-techdocs-link: https://docs.redhat.com/en/documentation/red_hat_developer_hub/1.8/html-single/manage_and_consume_technical_documentation_within_red_hat_developer_hub/index
-:manage-and-consume-techdocs-title: Manage and consume technical documentation within {product}
-:model-context-protocol-link: {product-docs-link}/html-single/interacting_with_model_context_protocol_tools_for_red_hat_developer_hub/index
-:model-context-protocol-title: Interacting with Model Context Protocol tools for {product}
+:manage-and-consume-techdocs-book-link: {product-docs-link}/html-single/manage_and_consume_technical_documentation_within_red_hat_developer_hub/index
+:manage-and-consume-techdocs-book-title: Manage and consume technical documentation within {product}
+:model-context-protocol-book-link: {product-docs-link}/html-single/interacting_with_model_context_protocol_tools_for_red_hat_developer_hub/index
+:model-context-protocol-book-title: Interacting with Model Context Protocol tools for {product}
 :monitoring-and-logging-book-link: {product-docs-link}/html-single/monitoring_and_logging/index
 :monitoring-and-logging-book-title: Monitoring and logging
-:navigate-rhdh-on-your-first-day-link: {product-docs-link}/html-single/navigate_red_hat_developer_hub_on_your_first_day/index
-:navigate-rhdh-on-your-first-day-title: Navigate {product} on your first day
+:navigate-rhdh-on-your-first-day-book-link: {product-docs-link}/html-single/navigate_red_hat_developer_hub_on_your_first_day/index
+:navigate-rhdh-on-your-first-day-book-title: Navigate {product} on your first day
 :observability-category-link: {product-docs-link}/#Observability
 :ocp-docs-link: link:https://docs.redhat.com/en/documentation/openshift_container_platform/{ocp-version}
 :odf-docs-link: link:https://docs.redhat.com/en/documentation/red_hat_openshift_data_foundation/{ocp-version}
-:openshift-ai-connector-for-rhdh-link: {product-docs-link}/html-single/accelerate_ai_development_with_openshift_ai_connector_for_red_hat_developer_hub/index
+:openshift-ai-connector-for-rhdh-book-link: {product-docs-link}/html-single/accelerate_ai_development_with_openshift_ai_connector_for_red_hat_developer_hub/index
+:openshift-ai-connector-for-rhdh-book-title: Accelerate AI development with {openshift-ai-connector-name}
 :orchestrator-book-link: {product-docs-link}/html-single/orchestrator_in_red_hat_developer_hub/index
 :orchestrator-book-title: Orchestrator in {product}
 :osd-docs-link: link:https://docs.redhat.com/en/documentation/openshift_dedicated/{osd-version}
@@ -184,6 +184,8 @@
 :rhoserverless-link: link:https://docs.redhat.com/en/documentation/red_hat_openshift_serverless/{rhoserverless-version}
 :scorecard-plugin-book-link: {product-docs-link}/html-single/evaluate_project_health_using_scorecards/index
 :scorecard-plugin-book-title: Evaluate project health using Scorecards
+:setting-up-and-configuring-book-link: {product-docs-link}/html-single/setting_up_and_configuring_your_first_red_hat_developer_hub_instance/index
+:setting-up-and-configuring-book-title: Setting up and configuring your first {product} instance
 :streamline-software-development-and-management-in-rhdh-book-link: {product-docs-link}/html-single/streamline_software_development_and_management_in_red_hat_developer_hub/index
 :streamline-software-development-and-management-in-rhdh-book-title: Streamline software development and management in {product}
 :techdocs-book-link: {product-docs-link}/html-single/techdocs_for_red_hat_developer_hub/index
@@ -193,7 +195,7 @@
 :upgrade-category-link: {product-docs-link}/#Upgrade
 :upgrading-book-link: {product-docs-link}/html-single/upgrading_red_hat_developer_hub/index
 :upgrading-book-title: Upgrading {product}
-:using-dynamic-plugins-book-link: {product-docs-link}/html-single/installing_and_viewing_plugins_in_red_hat_developer_hub/index
-:using-dynamic-plugins-book-title: Using dynamic plugins
+:using-dynamic-plugins-book-link: {product-docs-link}/html-single/using_dynamic_plugins_in_red_hat_developer_hub/index
+:using-dynamic-plugins-book-title: Using dynamic plugins in {product}
 
 

assemblies/get-started_navigate-rhdh-on-your-first-day/assembly-search-for-relevant-content-in-technical-documentation-techdocs.adoc

@@ -22,6 +22,6 @@ include::../modules/shared/proc-access-and-navigate-documentation.adoc[leveloffs
 [role="_additional-resources"]
 == Additional resources
 
-* {manage-and-consume-techdocs-link}[{manage-and-consume-techdocs-title}]
+* {manage-and-consume-techdocs-book-link}[{manage-and-consume-techdocs-book-title}]
 ifdef::parent-context[:context: {parent-context}]
 ifndef::parent-context[:!context:]

assemblies/shared/assembly-customize.adoc

@@ -7,7 +7,7 @@ ifdef::context[:parent-context: {context}]
 
 :context: customize
 [role="_abstract"]
-You can customize {ls-short} functionalities such as gathering feedback, storing chat history in PostgreSQL, and {model-context-protocol-link}#proc-configure-mcp-tools-for-developer-lightspeed_assembly-model-context-protocol-tools[configuring Model Context Protocol (MCP) tools].
+You can customize {ls-short} functionalities such as gathering feedback, storing chat history in PostgreSQL, and {model-context-protocol-book-link}#proc-configure-mcp-tools-for-developer-lightspeed_assembly-model-context-protocol-tools[configuring Model Context Protocol (MCP) tools].
 
 include::../modules/shared/proc-gather-feedback-in.adoc[leveloffset=+1]
 

modules/get-started_navigate-rhdh-on-your-first-day/con-overview-of-the-onboarding-workflow.adoc

@@ -13,26 +13,26 @@ Your first step will be to confirm that you log in as the correct user and that
 * *Authenticate*: Access your organization's {product-very-short} URL and log in using your corporate credentials.
 * *Check your identity*: Click your avatar or name in the Global Header and select *Settings*. Verify that the *User Entity* matches your corporate identity.
 * *Verify ownership*: Navigate to *My Profile* from the user menu. Check the *Ownership* card to confirm it lists the components, APIs, and systems you or your team are responsible for. If this list is empty, you might need to register your ownership in the Software Catalog.
-For more information, see {navigate-rhdh-on-your-first-day-link}#log-in-to-rhdh[Log in to {product-very-short}].
+For more information, see {navigate-rhdh-on-your-first-day-book-link}#log-in-to-rhdh[Log in to {product-very-short}].
 
 == Organize your workspace
 
 To reduce navigation time across the software ecosystem, curate a list of high-priority resources.
 
-* *Star your services*: Locate your often used components in the *Catalog* and select the *Add to favourites* (star) icon to add them to your favorites. See {navigate-rhdh-on-your-first-day-link}#managing-starred-items-for-quick-access[starred items].
+* *Star your services*: Locate your often used components in the *Catalog* and select the *Add to favourites* (star) icon to add them to your favorites. See {navigate-rhdh-on-your-first-day-book-link}#managing-starred-items-for-quick-access[starred items].
 * *Access starred items*: Use the *Starred Items* menu in the Global Header to open your favorite resources quickly.
-* *Pin the Sidebar*: Use this if you switch often between tools. The system pins the sidebar by default. To unpin the sidebar, go to *Settings* and clear *Pin Sidebar*. See {navigate-rhdh-on-your-first-day-link}#customize-interface-settings[Customize your {product-very-short} interface settings].
+* *Pin the Sidebar*: Use this if you switch often between tools. The system pins the sidebar by default. To unpin the sidebar, go to *Settings* and clear *Pin Sidebar*. See {navigate-rhdh-on-your-first-day-book-link}#customize-interface-settings[Customize your {product-very-short} interface settings].
 
 == Explore production resources
 
 Production instances give access to live infrastructure data and technical guides that you need for operational tasks.
 
-* {navigate-rhdh-on-your-first-day-link}#finding-and-viewing-techdocs[*See production documentation*]: Use the *Docs* menu to find production-specific documentation, such as run books or deployment guides linked to your components.
-* {navigate-rhdh-on-your-first-day-link}#verify-api-contracts-before-integration[*Check production APIs*]: Navigate to the *APIs* page to verify that production endpoint definitions are correct and discoverable.
-* {navigate-rhdh-on-your-first-day-link}#import-and-use-an-existing-template-for-faster-development[*Test Self-Service templates*]: Click *Create* (+) in the Global Header to review available Software Templates. Check that you have access to the Software Templates that you need to generate new production services.
+* {navigate-rhdh-on-your-first-day-book-link}#finding-and-viewing-techdocs[*See production documentation*]: Use the *Docs* menu to find production-specific documentation, such as run books or deployment guides linked to your components.
+* {navigate-rhdh-on-your-first-day-book-link}#verify-api-contracts-before-integration[*Check production APIs*]: Navigate to the *APIs* page to verify that production endpoint definitions are correct and discoverable.
+* {navigate-rhdh-on-your-first-day-book-link}#import-and-use-an-existing-template-for-faster-development[*Test Self-Service templates*]: Click *Create* (+) in the Global Header to review available Software Templates. Check that you have access to the Software Templates that you need to generate new production services.
 
 == Next steps
 
-* {navigate-rhdh-on-your-first-day-link}#con-navigate-the-rhdh-interface_quickly-gain-access-and-find-what-you-need-in-rhdh[*Start your day*]: Navigate to the {product-very-short} *Home Page* to view your personalized dashboard.
-* {navigate-rhdh-on-your-first-day-link}#con-navigate-the-rhdh-interface_quickly-gain-access-and-find-what-you-need-in-rhdh[*Learn the interface*]: Understand the Global Header and Sidebar tools.
-* {navigate-rhdh-on-your-first-day-link}#get-ai-assisted-help[*Get AI help*]: If enabled in production, open {ls-short} to ask questions about your new environment.
+* {navigate-rhdh-on-your-first-day-book-link}#con-navigate-the-rhdh-interface_quickly-gain-access-and-find-what-you-need-in-rhdh[*Start your day*]: Navigate to the {product-very-short} *Home Page* to view your personalized dashboard.
+* {navigate-rhdh-on-your-first-day-book-link}#con-navigate-the-rhdh-interface_quickly-gain-access-and-find-what-you-need-in-rhdh[*Learn the interface*]: Understand the Global Header and Sidebar tools.
+* {navigate-rhdh-on-your-first-day-book-link}#get-ai-assisted-help[*Get AI help*]: If enabled in production, open {ls-short} to ask questions about your new environment.

modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-configure-mcp-clients-to-access-the-rhdh-server.adoc

@@ -67,7 +67,7 @@ where:
 `<MCP_TOKEN>`:: Enter the previously configured static token
 `pass:c,a,q[{my-product-domain}]`:: Enter the hostname of your {product-very-short} instance
 
-. Configure *{ls-short}* as a client. For more details, see {developer-lightspeed-link}[{ls-brand-name}].
+. Configure *{ls-short}* as a client. For more details, see {developer-lightspeed-book-link}[{ls-brand-name}].
 .. In the `lightspeed-stack.yaml` configuration, add the following configuration for `mcp_servers`:
 +
 [source,yaml,subs="+attributes,+quotes"]

modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-configure-model-context-protocol-in-rhdh.adoc

@@ -10,7 +10,7 @@ You can enable your MCP client applications to use the MCP protocol to access {p
 
 .Prerequisites
 
-* You have {model-context-protocol-link}#install-the-mcp-server-and-tool-plugins-in-red-hat-developer-hub[installed the MCP server and tool plugins in {product}].
+* You have {model-context-protocol-book-link}#install-the-mcp-server-and-tool-plugins-in-red-hat-developer-hub[installed the MCP server and tool plugins in {product}].
 
 .Procedure
 

modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-resolve-authentication-issues-when-tools-are-not-found.adoc

@@ -18,4 +18,4 @@ If your MCP client connects to the server but cannot find deployed tools, an aut
 .. Use *legacy SSE endpoint* if your MCP client requires it instead of the Streamable endpoint. (For more details, see the *Configuration* topic).
 . Verify your {product-very-short} `{my-app-config-file}` file for duplicate backend entries and make sure that the indentation is accurate.
 .. Make sure that the configuration for the static token and MCP plugin sources go under an existing backend field, if one is present.
-.. If you are unsure, see {model-context-protocol-link}#configure-model-context-protocol-in-red-hat-developer-hub[the sample app configuration provided in the reference procedure].
+.. If you are unsure, see {model-context-protocol-book-link}#configure-model-context-protocol-in-red-hat-developer-hub[the sample app configuration provided in the reference procedure].