Merge branch 'main' into RHIDP-8196

Author: deerskindoll

artifacts/attributes.adoc

@@ -168,3 +168,9 @@
 :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
+
+:scorecard-plugin-book-link: {product-docs-link}/html-single/understand_and_visualize_red_hat_developer_hub_project_health_using_scorecards/index
+:scorecard-plugin-book-title: Understand and visualize {product} project health using Scorecards
+
+: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}

artifacts/snip-developer-preview.adoc renamed to artifacts/snip-developer-preview-lightspeed.adoc

@@ -0,0 +1,6 @@
+[IMPORTANT]
+====
+This section describes Developer Preview features in the Model Context Protocol plugin. Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to functionality in advance of possible inclusion in a Red Hat product offering. Customers can use these features to test functionality and provide feedback during the development process. Developer Preview features might not have any documentation, are subject to change or removal at any time, and have received limited testing. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA.
+
+For more information about the support scope of Red Hat Developer Preview features, see https://access.redhat.com/support/offerings/devpreview/[Developer Preview Support Scope].
+====

artifacts/snip-developer-preview-mcp.adoc

@@ -0,0 +1,6 @@
+[IMPORTANT]
+====
+This section describes Developer Preview features in the Scorecard plugin. Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to functionality in advance of possible inclusion in a Red Hat product offering. Customers can use these features to test functionality and provide feedback during the development process. Developer Preview features might not have any documentation, are subject to change or removal at any time, and have received limited testing. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA.
+
+For more information about the support scope of Red Hat Developer Preview features, see https://access.redhat.com/support/offerings/devpreview/[Developer Preview Support Scope].
+====

artifacts/snip-developer-preview-scorecard.adoc

@@ -0,0 +1,14 @@
+:_mod-docs-content-type: ASSEMBLY
+
+[id="assembly-configuring-scorecards-in-rhdh"]
+= Installing and configuring Scorecards to view metrics in your {product} instance
+:context: assembly-configuring-scorecards-in-rhdh
+
+You can install and configure the following Scorecards to display metrics and visual health status for software components in the {product-very-short} catalog:
+
+* GitHub Scorecards
+* Jira Scorecards
+
+include::modules/observe/scorecards/proc-configuring-github-scorecards-in-rhdh-instance.adoc[leveloffset=+1]
+
+include::modules/observe/scorecards/proc-configuring-jira-scorecards-in-rhdh-instance.adoc[leveloffset=+1]

assemblies/assembly-configuring-scorecards-in-rhdh.adoc

@@ -11,3 +11,5 @@ include::modules/configuring-the-quickstarts/proc-customize-rhdh-quickstart.adoc
 include::modules/configuring-the-quickstarts/proc-disabling-rhdh-quickstart.adoc[leveloffset=+2]
 
 include::modules/configuring-the-quickstarts/proc-starting-and-completing-modules-in-quickstarts.adoc[leveloffset=+1]
+
+include::modules/configuring-the-quickstarts/con-using-rbac-with-quickstarts.adoc[leveloffset=+1]

assemblies/assembly-configuring-the-quickstarts.adoc

@@ -0,0 +1,19 @@
+:_mod-docs-content-type: ASSEMBLY
+
+[id="assembly-model-context-protocol-tools"]
+= Interacting with Model Context Protocol tools for {product}
+:context: assembly-model-context-protocol-tools
+
+include::modules/model-context-protocol-tools/con-understanding-model-context-protocol.adoc[leveloffset=+1]
+
+include::modules/model-context-protocol-tools/proc-installing-the-mcp-server-and-tool-plugins.adoc[leveloffset=+1]
+
+include::modules/model-context-protocol-tools/proc-configuring-model-context-protocol.adoc[leveloffset=+1]
+
+include::modules/model-context-protocol-tools/proc-configuring-mcp-clients-to-access-the-rhdh-server.adoc[leveloffset=+2]
+
+include::modules/model-context-protocol-tools/proc-configuring-mcp-tools-for-developer-lightspeed.adoc[leveloffset=+1]
+
+include::assembly-using-the-mcp-tools-to-access-data.adoc[leveloffset=+1]
+
+include::assembly-troubleshooting-mcp-server-and-client-problems.adoc[leveloffset=+1]

assemblies/assembly-model-context-protocol-tools.adoc

@@ -45,4 +45,7 @@ include::modules/orchestrator/proc-helm-install-components-orchestrator-plugin.a
 include::modules/orchestrator/proc-manual-install-components-orchestrator-plugin.adoc[leveloffset=+2]
 
 // {product-very-short} helper script
-include::modules/orchestrator/proc-helper-script-overview.adoc[leveloffset=+2]
+include::modules/orchestrator/proc-helper-script-overview.adoc[leveloffset=+2]
+
+// best practices when creating workflows
+include::modules/orchestrator/ref-best-practices-for-creating-workflows.adoc[leveloffset=+1]

assemblies/assembly-orchestrator-rhdh.adoc

@@ -0,0 +1,29 @@
+:_mod-docs-content-type: ASSEMBLY
+
+[id="assembly-rhdh-observability"]
+= Understanding and visualizing {product} project health using Scorecards
+:context: assembly-scorecards-rhdh
+
+include::modules/observe/scorecards/con-understand-scorecard-plugins.adoc[leveloffset=+1]
+
+include::modules/observe/scorecards/ref-supported-metrics-providers.adoc[leveloffset=+2]
+
+include::assembly-setting-up-scorecards-to-monitor-your-rhdh-health.adoc[leveloffset=+1]
+
+include::assembly-configuring-scorecards-in-rhdh.adoc[leveloffset=+1]
+
+include::modules/observe/scorecards/con-manage-metric-thresholds-in-scorecard-plugin.adoc[leveloffset=+1]
+
+include::modules/observe/scorecards/con-how-thresholds-work.adoc[leveloffset=+2]
+
+include::modules/observe/scorecards/ref-supported-threshold-expressions.adoc[leveloffset=+2]
+
+include::modules/observe/scorecards/ref-threshold-rules-to-metrics-for-scorecard-plugin.adoc[leveloffset=+2]
+
+include::modules/observe/scorecards/con-set-global-standards-for-metric-thresholds.adoc[leveloffset=+2]
+
+include::modules/observe/scorecards/ref-override-rules-to-configure-entity-specific-thresholds.adoc[leveloffset=+2]
+
+include::modules/observe/scorecards/con-best-practices-for-threshold-rules.adoc[leveloffset=+2]
+
+include::modules/observe/scorecards/proc-viewing-scorecards-in-rhdh.adoc[leveloffset=+1]

assemblies/assembly-scorecards-rhdh.adoc

@@ -0,0 +1,9 @@
+:_mod-docs-content-type: ASSEMBLY
+
+[id="assembly-setting-up-scorecards-to-monitor-your-rhdh-health"]
+= Setting up Scorecards to monitor your {product} project health
+:context: assembly-setting-up-scorecards-to-monitor-your-rhdh-health
+
+include::modules/observe/scorecards/proc-installing-scorecard-plugin-in-rhdh-instance.adoc[leveloffset=+1]
+
+include::modules/observe/scorecards/proc-authenticating-and-managing-scorecard-plugins.adoc[leveloffset=+1]