[WIP] RHDEVDOCS-6146: Update Condition management commands section to follow correct style

.ci-operator.yaml

@@ -0,0 +1,4 @@
+build_root_image:
+  namespace: openshift
+  name: release
+  tag: golang-1.15

.devcontainer/devcontainer.json

@@ -1,24 +1,15 @@
 {
-  "name": "ruby 2",
-
-  "image": "mcr.microsoft.com/vscode/devcontainers/ruby:2.7",
-  //"image": "quay.io/rhn_support_gmcgoldr/vscode-ruby27-asciibinder",
-
-  "postCreateCommand": "gem install asciidoctor asciidoctor-diagram ascii_binder && asciibinder build --distro=openshift-enterprise && BR=\"$(git branch --show-current)\" && cd _preview/openshift-enterprise/$BR &&  ln -s welcome/index.html index.html && ruby -run -ehttpd . -p8000"
-  //"postCreateCommand": "asciibinder build --distro=openshift-enterprise && cd _preview/openshift-enterprise/main &&  ln -s welcome/index.html index.html && ruby -run -ehttpd . -p8000"
-
-  // Features to add to the dev container. More info: https://containers.dev/features.a
-  // "features": {},
-
-  // Use 'forwardPorts' to make a list of ports inside the container available locally.
-  // "forwardPorts": [],
-
-  // Use 'postCreateCommand' to run commands after the container is created.
-  // "postCreateCommand": "pip3 install --user -r requirements.txt",
-
-  // Configure tool-specific properties.
-  // "customizations": {},
-
-  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
-  // "remoteUser": "root"
-}
+  "image":"mcr.microsoft.com/devcontainers/universal:2",
+  "postCreateCommand": "sleep 60  && docker run --rm -it -v `pwd`:/docs:Z quay.io/openshift-cs/asciibinder sh -c \"git config --global --add safe.directory /docs && asciibinder build --distro openshift-rosa && asciibinder build --distro openshift-enterprise\" && python3 -m http.server -d ./_preview",
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "search.followSymlinks": false,
+        "workbench.editor.enablePreview": false
+      },
+      "extensions": [
+        "asciidoctor.asciidoctor-vscode"
+      ]
+    }
+  }
+}

.github/CODEOWNERS

@@ -1 +1 @@
-@kalexand-rh @JoeAldinger @bergerhoffer @adellape @sjhala-ccs @apinnick @ousleyp
+ @abhatt-rh @abrennan89 @adellape @aireilly @bergerhoffer @bscott-rh @gabriel-rh @jab-rh @jeana-redhat @JoeAldinger @kalexand-rh @kcarmichael08 @michaelryanpeter @opayne1 @ousleyp @sjhala-ccs @snarayan-redhat @Srivaralakshmi

.s2i/httpd-cfg/01-community.conf

@@ -159,10 +159,20 @@ AddType text/vtt                            vtt
     RewriteRule ^latest/install_config/upgrades\.html(.*)$ /latest/install_config/upgrading/index.html$1 [NE,R=301]
     RewriteRule ^latest/install_config/upgrading/(.*)$ /latest/upgrading/$1 [NE,R=301]
 
+    # The following rule prevents an infinite redirect loop when browsing to /(latest|4\.16)/virt/about_virt/about-virt.html
+    # RewriteRule ^(latest|4\.17)/virt/about_virt/about-virt.html$ - [L]
+
     # OpenShift Virtualization (CNV) catchall redirect; use when CNV releases asynchronously from OCP. Do not change the 302 to a 301.
     # When uncommented, this redirects all `virt` directory traffic to the about-virt page.
+    # Pay mind to the redirect directly above this which prevents redirect loops.
+    # To activate the redirects, uncomment the next and previous lines and update the version number to the pending release.
+    # RewriteRule ^(latest|4\.17)/virt/(?!about-virt\.html)(.+)$ /$1/virt/about_virt/about-virt.html [NE,R=302]
+
+    # Red Hat OpenShift support for Windows Containers (WMCO) catchall redirect; use when WMCO releases asynchronously from OCP. Do not change the 302 to a 301.
+    # When uncommented, this redirects all `windows_containers` directory traffic to the /windows_containers/index.html page.
     # To activate the redirects, uncomment the next line and update the version number to the pending release.
-    # RewriteRule ^(latest|4\.12)/virt/(?!about-virt\.html)(.+)$ /$1/virt/about-virt.html [NE,R=302]
+    # RewriteRule ^(latest|4\.15)/windows_containers/(?!index\.html)(.+)$ /$1/windows_containers/index.html [NE,R=302]
+    # RewriteRule ^(latest|4\.15)/support/troubleshooting/troubleshooting-windows-container-workload-issues\.html(.*)$ /$1/windows_containers/index.html [NE,R=302]
 
   </Directory>
 </IfModule>

.travis.yml.old

@@ -0,0 +1,36 @@
+language: python
+cache:
+  pip: true
+
+git:
+  depth: 10
+jobs:
+  include:
+    - name: "Preview, validate, and build"
+      before_install:
+      - if [ "$TRAVIS_BRANCH" != "main" ]; then chmod +x autopreview.sh && ./autopreview.sh; fi
+      install:
+        - gem install --local _gemfiles/asciidoctor-2.0.20.gem _gemfiles/asciidoctor-diagram-plantuml-1.2023.10.gem _gemfiles/asciidoctor-diagram-ditaamini-1.0.3.gem _gemfiles/rexml-3.2.6.gem _gemfiles/asciidoctor-diagram-2.2.14.gem _gemfiles/rouge-4.1.3.gem
+        - pip3 install pyyaml aura.tar.gz
+      script:
+        # Fail if Asciidoctor encounters errors. Or if release notes has links to internal bugs. Pass otherwise. Then, build updated distros
+        - chmod +x ./scripts/check-rn-link-perms.sh
+        - ./scripts/check-rn-link-perms.sh || travis_terminate 1
+        - chmod +x ./scripts/check-asciidoctor-build.sh
+        - chmod +x ./scripts/get-updated-distros.sh
+        - ./scripts/check-asciidoctor-build.sh || travis_terminate 1
+        - |
+          ./scripts/get-updated-distros.sh |
+            while read -r filename; do
+              if [ "$filename" == "_topic_maps/_topic_map.yml" ]; then python3 build.py --distro openshift-enterprise --product "OpenShift Container Platform" --version 4.15 --no-upstream-fetch || travis_terminate 1
+
+              elif [ "$filename" == "_topic_maps/_topic_map_osd.yml" ]; then python3 build.py --distro openshift-dedicated --product "OpenShift Dedicated" --version 4 --no-upstream-fetch || travis_terminate 1
+
+              elif [ "$filename" == "_topic_maps/_topic_map_ms.yml" ]; then python3 build.py --distro microshift --product "Microshift" --version 4 --no-upstream-fetch || travis_terminate 1
+
+              elif [ "$filename" == "_topic_maps/_topic_map_rosa.yml" ]; then python3 build.py --distro openshift-rosa --product "Red Hat OpenShift Service on AWS" --version 4 --no-upstream-fetch || travis_terminate 1
+
+              elif [ "$filename" == "_distro_map.yml" ]; then python3 build.py --distro openshift-enterprise --product "OpenShift Container Platform" --version 4.15 --no-upstream-fetch || travis_terminate 1
+              fi
+            done
+        - if [ -d "drupal-build" ]; then python3 makeBuild.py || travis_terminate 1; fi

.vale.ini

@@ -2,18 +2,14 @@ StylesPath = .vale/styles
 
 MinAlertLevel = suggestion
 
-Packages = RedHat, https://github.com/redhat-documentation/vale-at-red-hat/releases/latest/download/AsciiDoc.zip, https://github.com/redhat-documentation/vale-at-red-hat/releases/latest/download/OpenShiftAsciiDoc.zip
+Packages = RedHat, AsciiDoc, OpenShiftAsciiDoc
 
 Vocab = OpenShiftDocs
 
 # Ignore files in dirs starting with `.` to avoid raising errors for `.vale/fixtures/*/testinvalid.adoc` files
 [[!.]*.adoc]
 BasedOnStyles = RedHat, AsciiDoc, OpenShiftAsciiDoc
 
-# Optional: pass doc attributes to asciidoctor before linting
-#[asciidoctor]
-#openshift-enterprise = YES
-
 # Disabling rules (NO)
 RedHat.ReleaseNotes = NO
 
@@ -25,3 +21,12 @@ Vale.Avoid = YES
 OpenShiftAsciiDoc.ModuleContainsParentAssemblyComment = NO
 OpenShiftAsciiDoc.NoNestingInModules = NO
 OpenShiftAsciiDoc.NoXrefInModules = NO
+OpenShiftAsciiDoc.IdHasContextVariable = NO
+OpenShiftAsciiDoc.NoTocInModules = NO
+
+# Optional: pass doc attributes to asciidoctor before linting
+# Temp values are used for Prow CI comment linting only
+[asciidoctor]
+temp-ifdef = YES
+temp-ifndef = NO
+temp-ifeval = temp

.vale/styles/config/vocabularies/OpenShiftDocs/accept.txt

@@ -0,0 +1,30 @@
+# Regex terms added to accept.txt are ignored by the Vale linter and override RedHat Vale rules.
+# Add terms that have a corresponding incorrectly capitalized form to reject.txt.
+[Ff]ronthaul
+[Mm][Bb]ps
+[Mm]idhaul
+[Oo]n-premise
+[Pp]assthrough
+[Pp]ostinstall
+[Pp]recaching
+[Pp]reinstall
+[Rr]ealtime
+[Tt]elco
+[Uu]npause
+Assisted Installer
+Control Plane Machine Set Operator
+custom resources?
+GHz
+gpsd
+gpspipe
+hyperthreads?
+KPIs?
+linuxptp
+Mellanox
+MetalLB
+NICs?
+pmc
+ubxtool
+vDUs?
+VFs?
+Westport

.vale/styles/Vocab/OpenShiftDocs/reject.txt → .vale/styles/config/vocabularies/OpenShiftDocs/reject.txt

@@ -11,5 +11,4 @@ configuration maps?
 MachineSets
 machinesets?
 minions?
-operators?
-SNO
+SNO

.vale/templates/bot-comment-output.tmpl

@@ -0,0 +1,48 @@
+{{- /* Modify Vale's output https://docs.errata.ai/vale/cli#--output */ -}}
+
+{{- /* Keep track of our various counts */ -}}
+
+{{- $e := 0 -}}
+{{- $w := 0 -}}
+{{- $s := 0 -}}
+
+{{- /* Range over the linted files */ -}}
+[
+{{- range $jdx, $file := .Files -}}
+    {{- $path := .Path -}}
+    {{- /* Range over the file's alerts */ -}}
+    {{- if $jdx -}},{{- end -}}
+    {{- range $idx, $a := .Alerts -}}
+
+        {{- $error := "" -}}
+        {{- if eq .Severity "error" -}}
+            {{- $error = "error" -}}
+            {{- $e = add1 $e  -}}
+        {{- else if eq .Severity "warning" -}}
+            {{- $error = "warning" -}}
+            {{- $w = add1 $w -}}
+        {{- else -}}
+            {{- $error = "suggestion" -}}
+            {{- $s = add1 $s -}}
+        {{- end}}
+
+        {{- /* Variables setup */ -}}
+        {{- $loc := printf "%d" .Line -}}
+        {{- $check := printf "%s" .Check -}}
+        {{- $message := printf "%s" .Message -}}
+        {{- /* Only add a link for RedHat rule errors */ -}}
+        {{- $link := "" -}}
+        {{- if contains "RedHat." .Check -}}
+            {{- $link = printf "For more information, see [%s](https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/%s)." .Check (lower (trimPrefix "RedHat." .Check)) -}}
+        {{- end -}}
+        {{- if $idx -}},{{- end -}}
+
+        {{- /* Output */ -}}
+        {
+            "body": "🤖 **[{{ $error }}] {{$check}}**: {{ $message }} {{ $link }}",
+            "path": "{{ $path }}",
+            "line": {{ $loc }}
+        }
+    {{end -}}
+{{end -}}
+]

.yamllint

@@ -0,0 +1,11 @@
+---
+extends: relaxed
+rules:
+  indentation: { spaces: 2, indent-sequences: false }
+  line-length: disable
+  colons:
+    max-spaces-before: 0
+    max-spaces-after: 1
+  empty-lines: disable
+  trailing-spaces: enable
+  new-line-at-end-of-file: enable

404-commercial.html

@@ -167,7 +167,7 @@ <h1>Not found</h1>
     <div class="container">
         <div class="row">
             <div class="col-sm-2">
-                <img src="https://assets.openshift.com/hubfs/images/logos/Logo-RedHat-A-Reverse-RGB.svg" class="img-fluid" alt="Red Hat" style="height: 30px;">
+                <img src="https://assets.openshift.net/content/img/Logo-Red_Hat-OpenShift-A-Reverse-RGB.svg" class="img-fluid" alt="Red Hat" style="height: 30px;">
             </div>
 
             <div class="col-sm-3">

CONTRIBUTING.adoc

@@ -0,0 +1,27 @@
+= Contributing to OpenShift documentation
+// NOTE: This text mirrors the "Contributing to OpenShift documentation" section in ./README.adoc
+// If you update one, update both.
+
+If you are interested in contributing to OpenShift technical documentation, you can view all our link:./contributing_to_docs[resources] that will help you get set up and provide more information.
+
+
+The following table provides quick links to help you get started.
+
+[options="header"]
+|===
+
+|Question |Link
+
+|I'm interested, how do I contribute?
+|See the link:/contributing_to_docs/contributing.adoc[contributing] topic to learn more about this repository and how you can contribute.
+
+|Are there any basic guidelines to help me?
+|The link:/contributing_to_docs/doc_guidelines.adoc[documentation guidelines] topic provides some basic guidelines to help us keep our content consistent, and includes other style information.
+
+|How do I set up my workstation?
+|See the link:/contributing_to_docs/tools_and_setup.adoc[tools and setup] topic to set up your workstation.
+
+|How do I edit an existing topic, or create new content?
+|See the link:/contributing_to_docs/create_or_edit_content.adoc[create or edit content] topic to get started.
+
+|===