chore: lint docs + CI job (#7959)

Signed-off-by: Michael Crenshaw <michael@crenshaw.dev>

.github/workflows/ci-build.yaml

@@ -434,3 +434,20 @@ jobs:
           name: e2e-server-k8s${{ matrix.k3s-version }}.log
           path: /tmp/e2e-server.log
         if: ${{ failure() }}
+
+  lint-docs:
+    name: Lint docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+      - name: Setup Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: '3.x'
+      - name: Install dependencies
+        run: |
+          pip install -r docs/requirements.txt
+      - name: Lint docs
+        run: |
+          make lint-docs

CHANGELOG.md

@@ -823,7 +823,7 @@ More documentation and tools are coming in patch releases.
 The Argo CD deletes all **in-flight** hooks if you terminate running sync operation. The hook state assessment change implemented in this release the Argo CD enables detection of 
 an in-flight state for all Kubernetes resources including `Deployment`, `PVC`, `StatefulSet`, `ReplicaSet` etc. So if you terminate the sync operation that has, for example,
 `StatefulSet` hook that is `Progressing` it will be deleted. The long-running jobs are not supposed to be used as a sync hook and you should consider using
-[Sync Waves](https://argoproj.github.io/argo-cd/user-guide/sync-waves/) instead.
+[Sync Waves](https://argo-cd.readthedocs.io/en/stable/user-guide/sync-waves/) instead.
 
 #### Enhancements
 * feat: Add custom health checks for cert-manager v0.11.0 (#2689) 

docs/operator-manual/upgrading/1.3-1.4.md

@@ -5,7 +5,7 @@
 The Argo CD deletes all **in-flight** hooks if you terminate running sync operation. The hook state assessment change implemented in this release the Argo CD enables detection of 
 an in-flight state for all Kubernetes resources including `Deployment`, `PVC`, `StatefulSet`, `ReplicaSet` etc. So if you terminate the sync operation that has, for example,
 `StatefulSet` hook that is `Progressing` it will be deleted. The long-running jobs are not supposed to be used as a sync hook and you should consider using
-[Sync Waves](https://argoproj.github.io/argo-cd/user-guide/sync-waves/) instead.
+[Sync Waves](../../user-guide/sync-waves.md) instead.
  
 From here on you can follow the [regular upgrade process](./overview.md).
 

docs/operator-manual/upgrading/2.0-2.1.md

@@ -25,7 +25,7 @@ and [argocd-repo-creds.yaml](../argocd-repo-creds.yaml).
 
 The `argocd-util` CLI commands are available under `argocd admin` and the `argocd-util` binary is no longer available.
 
-## Replace runtime system user while [BYOI](https://argoproj.github.io/argo-cd/operator-manual/custom_tools/#byoi-build-your-own-image)
+## Replace runtime system user while [BYOI](../custom_tools.md#byoi-build-your-own-image)
 
 Runtime system user should to be changed from `argocd` to `999`, as shown below.
 

docs/user-guide/parameters.md

@@ -78,7 +78,7 @@ The `.argocd-source` is trying to solve two following main use cases:
 - Provide the unified way to "override" application parameters in Git and enable the "write back" feature
 for projects like [argocd-image-updater](https://github.com/argoproj-labs/argocd-image-updater).
 - Support "discovering" applications in the Git repository by projects like [applicationset](https://github.com/argoproj-labs/applicationset)
-(see [git files generator](https://github.com/argoproj-labs/applicationset/blob/master/examples/git-files-discovery.yaml))
+(see [git files generator](https://github.com/argoproj-labs/applicationset/blob/master/examples/git-generator-files-discovery/git-generator-files.yaml))
 
 > The following is available from v1.9 or later
 

white-list

@@ -23,6 +23,7 @@ kubernetes.default.svc:443
 localhost:4000
 localhost:6443
 localhost:8080
+localhost:8085
 mycluster.com
 storage.googleapis.com
 ui.argocd.yourorganization.net
@@ -31,3 +32,37 @@ your-kubernetes-cluster-addr
 yourorganization.oktapreview.com
 yourorganization.oktapreview.com:443
 example-OIDC-provider.com
+argocd-dex-server:5556
+ghe.example.com
+proxy-server-url:8888
+keycloak.example.com
+argocd.myproject.com
+argocd.apps.domain.com
+k8sou.apps.192-168-2-144.nip.io
+your.argoingress.address
+your.domain
+external.path.to.argocd.io
+my-argo-cd-url
+my-login-url
+login.microsoftonline.com/xxxxx
+accounts.google.com/o/saml2/idp?idpid=Abcde0
+accounts.google.com/o/saml2?idpid=Abcde0
+sso-url
+google-entity-id
+github.com/argoproj/argo-cd/manifests/crds
+example.com
+form.example.com
+grafana.example.com
+10.5.39.39
+chat.googleapis.com/v1/spaces/
+mattermost.example.com
+my-grafana.com
+github.my-company.com
+1.2.3.4
+2.4.6.8
+9.8.7.6
+ghe.example.com
+12.34.567.89
+192.168.99.100:8443
+github.com/yourghuser/argo-cd
+github.com/argoproj/argo-cd/releases/download/