Merge pull request #3357 from cnvergence/add-authn-docs

🐛 fix: mermaid mkdocs error and add make target to run mkdocs locally

Author: kcp-ci-bot

.gitignore

@@ -45,3 +45,5 @@ dex/
 *.crt
 *.key
 *.pem
+
+index.html

Makefile

@@ -170,6 +170,11 @@ generate-api-docs: ## Generate api docs
 VENVDIR=$(abspath docs/venv)
 REQUIREMENTS_TXT=docs/requirements.txt
 
+.PHONY: local-docs
+local-docs: venv ## Run mkdocs serve
+	. $(VENV)/activate; \
+	VENV=$(VENV) cd docs && mkdocs serve
+
 .PHONY: serve-docs
 serve-docs: venv ## Serve docs
 	. $(VENV)/activate; \

docs/content/concepts/authentication/index.md

@@ -29,17 +29,16 @@ You can configure them with the settings from Kubernetes control plane [strategi
 ### Authentication Flow With Client Certificate
 
 ```mermaid
-flowchart
-	n1@{ label: "Rectangle" }
-	n1["A client sends a request
-  with a client certificate."] --- n2
-	n2["The proxy verifies the
-  certificate against a trusted CA."] --- n3
-	n3["Filters specified
-  groups from requests."] --- n4
-	n4["Extracts the user and
+flowchart TD
+    n1["A client sends a request
+  with a client certificate."] --> n2
+    n2["The proxy verifies the
+  certificate against a trusted CA."] --> n3
+    n3["Filters specified
+  groups from requests."] --> n4
+    n4["Extracts the user and
   groups and passing them
-  as HTTP access headers."] --- n5["Forwards the request
+  as HTTP access headers."] --> n5["Forwards the request
   to the kcp API server."]
 ```
 

docs/content/concepts/authentication/oidc.md

@@ -44,7 +44,7 @@ You can also set:
 ## Configure kcp OIDC Authentication Using Structured Authentication Configuration
 
 Alternatively, you can use the beta feature of authentication configuration from a file and set up the kcp server with it.
-Please note that iff you specify --authentication-config along with any of the --oidc-* command line arguments, this will be treated as a misconfiguration.
+Please note that if you specify `--authentication-config` along with any of the `--oidc-*` command line arguments, this will be treated as a misconfiguration.
 
 ```bash
 apiVersion: apiserver.config.k8s.io/v1beta1