DOCS-1007: Create sync pattern to pull in the CRD during releases (#1025

)

Closes #1007

Makefile

@@ -236,6 +236,9 @@ sync-minio-version:
 sync-sdks:
 	@(./sync-docs.sh)
 
+sync-operator-crd:
+	@(./sync-minio-operator-crd.sh)
+
 # Can probably safely remove this at some point
 sync-deps:
 # C++ and Rust repos do not have any releases yet.

README.md

@@ -9,7 +9,7 @@ MinIO uses [Sphinx](https://www.sphinx-doc.org/en/master/index.html) to generate
 - Any GNU/Linux Operating System, or macOS 12.3 or later.
 - python 3.10.x and python-pip
 - python3.10-venv
-- sphinx 4.3.2
+- sphinx 6.2.1
 - nodejs 14.5.0 or later
 - npm 16.19.1 or later
 - `git` or a git-compatible client
@@ -69,6 +69,27 @@ Does the following:
 1. Check that the `build/GITDIR/linux` folder exists
 2. Copies the contents of `build/GITDIR/linux/html/*` to `docs-staging/staging/GITDIR/linux`
 
+# Syncing Operator CRD Docs
+
+For importing the Operator CRD Docs specifically, you must have:
+
+- pandoc (latest stable)
+- asciidoc (latest stable)
+
+In addition to all other prerequisites.
+
+Run 
+
+```
+make sync-operator-crd
+```
+
+This downloads and converts the `tenant-crd.adoc` from the MinIO Operator github repository.
+It converts it to XML, then to markdown.
+Finally, it does some `sed` find/replace to tidy up the file for Sphinx ingest.
+
+You can run this when we have a new Operator release being documented, assuming there are changes to the CRD as part of that release.
+
 # License
 
 This project is licensed under a [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/legalcode). See [CONTRIBUTING.md](https://github.com/minio/docs/tree/master/CONTRIBUTING.md) guide for more information on contributing to the MinIO Documentation project.

source/_static/scss/includes/_misc.scss

@@ -370,4 +370,14 @@ figcaption {
       font-size: small;
       font-weight: bold;
    }
+}
+
+
+// ---------------------------------------
+// Fixing table issues from asciidoc -> md
+// ---------------------------------------
+
+table thead tr.header {
+   background-color: lightgray;
+   box-shadow: none;
 }