Merge branch 'main' into RHIDP-7612

Author: themr0c

.gitignore

@@ -2,7 +2,10 @@
 titles/*/build
 index.html
 titles-generated/
+.vale-styles/AsciiDocDITA
 .vale-styles/RedHat
 .vscode
 .cache/
 .vscode/
+linkchecker-out.csv
+linkchecker-out.html

.htmltest.yml

@@ -10,4 +10,10 @@ OutputDir: .cache/htmltest
 IgnoreDirectoryMissingTrailingSlash: true
 IgnoreSSLVerify: true
 IgnoreURLs: # List URLS that are not published, false positives, websites refusing crawlers
+  # Unauthorized (403)
+  - https://docs.redhat.com/en/documentation/red_hat_developer_hub
+  - https://developers.redhat.com
   - https://docs.github.com/
+  - https://entra.microsoft.com
+  - https://openai.com/api/
+  - https://platform.openai.com/docs/overview

.linkcheckerrc

@@ -0,0 +1,14 @@
+; Run linkchecker with the configuration file:
+; linkchecker -f .linkcheckerrc titles-generated/main/
+
+[filtering]
+checkextern=True
+ignore=
+  brand.css
+  lang.css
+  http://creativecommons.org/licenses/by-sa/3.0/
+  https://access.redhat.com/downloads/content/480/
+
+[output]
+fileoutput=html,csv
+log=failures

.vale-styles/config/vocabularies/RHDH/accept.txt

@@ -0,0 +1 @@
+scaffolder

.vale-styles/config/vocabularies/RHDH/reject.txt

@@ -10,9 +10,16 @@ StylesPath = ".vale-styles"
 MinAlertLevel = suggestion
 
 # Styles to download:
-Packages = RedHat
+Packages = RedHat,https://github.com/jhradilek/asciidoctor-dita-vale/releases/latest/download/AsciiDocDITA.zip
+
+Vocab = RHDH
 
 # Display alerts on AsciiDoc files:
 [*.adoc]
 # Apply these styles:
-BasedOnStyles = RedHat,DeveloperHub
+BasedOnStyles = RedHat,DeveloperHub,AsciiDocDITA
+
+# Disable certain rules:
+AsciiDocDITA.AttributeReference = NO
+AsciiDocDITA.ShortDescription = NO
+AsciiDocDITA.CrossReference = NO

.vale.ini

@@ -1,5 +1,6 @@
 {
     "cSpell.words": [
-        "preconfigured"
+        "preconfigured",
+        "quicklinks"
     ]
 }

.vscode/settings.json

@@ -1,6 +1,6 @@
 = Enabling the Argo CD plugin
 
-You can use the Argo CD plugin to visualize the Continuous Delivery (CD) workflows in OpenShift GitOps. This plugin provides a visual overview of the application’s status, deployment details, commit message, author of the commit, container image promoted to environment and deployment history.
+You can use the Argo CD plugin to visualize the Continuous Delivery (CD) workflows in OpenShift GitOps. This plugin provides a visual overview of the status of the application, deployment details, commit message, author of the commit, container image promoted to environment and deployment history.
 
 .Prerequisites
 
@@ -22,8 +22,13 @@ argocd:
           username: ${ARGOCD_USERNAME}
           password: ${ARGOCD_PASSWORD}
 ----
++
+[NOTE]
+====
+Avoid using a trailing slash in the `url`, as it might cause unexpected behavior.
+====
 
-* Add the following annotation to the entity’s `catalog-info.yaml` file to identify the Argo CD applications.
+* Add the following annotation to the entity `catalog-info.yaml` file to identify the Argo CD applications.
 
 +
 [source,yaml]
@@ -32,7 +37,7 @@ annotations:
   ...
   # The label that Argo CD uses to fetch all the applications. The format to be used is label.key=label.value. For example, rht-gitops.com/janus-argocd=quarkus-app.
 
-  argocd/app-selector: '${ARGOCD_LABEL_SELECTOR}' 
+  argocd/app-selector: '${ARGOCD_LABEL_SELECTOR}'
 ----
 
 * (Optional) Add the following annotation to the entity’s `catalog-info.yaml` file to switch between Argo CD instances as shown in the following example:
@@ -44,7 +49,7 @@ annotations:
    ...
     # The Argo CD instance name used in `app-config.yaml`.
 
-    argocd/instance-name: '${ARGOCD_INSTANCE}' 
+    argocd/instance-name: '${ARGOCD_INSTANCE}'
 ----
 
 +
@@ -76,7 +81,7 @@ The optional Argo CD Rollouts feature enhances Kubernetes by providing advanced
 
 .Prerequisites
 
-* The Backstage Kubernetes plugin (`@backstage/plugin-kubernetes`) is installed and configured. 
+* The Backstage Kubernetes plugin (`@backstage/plugin-kubernetes`) is installed and configured.
 
 ** To install and configure Kubernetes plugin in Backstage, see link:https://backstage.io/docs/features/kubernetes/installation/[Installaltion] and link:https://backstage.io/docs/features/kubernetes/configuration/[Configuration] guide.
 
@@ -208,7 +213,7 @@ If using the label selector annotation (backstage.io/kubernetes-label-selector),
 
 . Open {Product} interface and navigate to the entity you configured.
 
-. Select the *CD* tab and then select the *GitOps application*. The side panel opens. 
+. Select the *CD* tab and then select the *GitOps application*. The side panel opens.
 
 . In the *Resources* table of the side panel, verify that the following resources are displayed:
 
@@ -226,6 +231,5 @@ If using the label selector annotation (backstage.io/kubernetes-label-selector),
 [role="_additional-resources"]
 .Additional resources
 
-* The package path, scope, and name of the {company-name} ArgoCD plugin has changed since 1.2. For more information, see link:{release-notes-book-url}#removed-functionality-rhidp-4293[Breaking Changes] in the _{release-notes-book-title}_.
 
-* For more information on installing dynamic plugins, see link:{installing-and-viewing-plugins-book-url}[{installing-and-viewing-plugins-book-title}].
+* link:{installing-and-viewing-plugins-book-link}[{installing-and-viewing-plugins-book-title}]

artifacts/attributes.adoc

@@ -12,7 +12,7 @@ You can use the Argo CD plugin to visualize the Continuous Delivery (CD) workflo
 
 . Select the *Catalog* tab and choose the component that you want to use.
 
-. Select the *CD* tab to view insights into deployments managed by Argo CD. 
+. Select the *CD* tab to view insights into deployments managed by Argo CD.
 
 +
 image::rhdh-plugins-reference/argocd.png[CD tab Argo CD]
@@ -33,4 +33,4 @@ image::rhdh-plugins-reference/deployment_summary.png[Deployment summary]
 [role="_additional-resources"]
 .Additional resources
 
-* For more information on installing dynamic plugins, see link:{installing-and-viewing-plugins-book-url}[{installing-and-viewing-plugins-book-title}].
+* {installing-and-viewing-plugins-book-link}[{installing-and-viewing-plugins-book-title}]