Fix Netlify build failure from template syntax error and PATH issues in documentation (#17767)

* Initial plan

* Fix Netlify build by escaping Go template syntax in scaleway.md

Co-authored-by: hakman <[email protected]>

* Fix Netlify strict mode build by removing missing canal.md reference and excluding conflicting README.md

Co-authored-by: hakman <[email protected]>

* Simplify exclude_docs syntax in mkdocs.yml

Co-authored-by: hakman <[email protected]>

* Fix mkdocs command not found in Netlify by using python -m mkdocs

Co-authored-by: hakman <[email protected]>

* Revert exclude_docs change from mkdocs.yml

Co-authored-by: hakman <[email protected]>

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: hakman <[email protected]>

Author: Copilot

Makefile

@@ -609,7 +609,7 @@ build-docs:
 .PHONY: build-docs-netlify
 build-docs-netlify:
 	pip install -r ${KOPS_ROOT}/images/mkdocs/requirements.txt
-	mkdocs build
+	python -m mkdocs build
 
 #-----------------------------------------------------------
 # development targets

docs/getting_started/scaleway.md

@@ -160,7 +160,7 @@ for SERVER in "${TF_SERVERS[@]}"; do
   # We remove the stale instance from the state
   terraform state rm scaleway_instance_server.$SERVER
   # We fetch its new ID
-  NEW_SERVER_ID=$(scw instance server list zone=$ZONE name=$SERVER -o template="{{ .ID }}")
+  NEW_SERVER_ID=$(scw instance server list zone=$ZONE name=$SERVER -o template="{% raw %}{{ .ID }}{% endraw %}")
   if [ "$NEW_SERVER_ID" == "" ]; then
     echo "could not find new ID of the server $SERVER"
   fi

mkdocs.yml

@@ -123,7 +123,6 @@ nav:
     - CNI:
       - AWS VPC: "networking/aws-vpc.md"
       - Calico: "networking/calico.md"
-      - Canal: "networking/canal.md"
       - Cilium: "networking/cilium.md"
       - Flannel: "networking/flannel.md"
       - Kube-Router: "networking/kube-router.md"