Support migration to Google Analytics 4 (GA4) - upgrade mkdocs-material to v7.1.8+

[chalin]

• For the umbrella issue, see Migrate to Google Analytics 4 (GA4) argo-site#102.
• As of the time of writing this, the docs are built from mkdocs-material==7.1.7 (for GA support of 7.1.7, see here):
  

  argo-cd/docs/requirements.txt

  Lines 1 to 2 in 90760a5

  	mkdocs==1.2.3
  	mkdocs-material==7.1.7

  
  We need at least 7.1.8 (the next patch release), in order to have support for GA4, as documented here:

  

---

• Upgrade mkdocs-material to v7.1.8+
• If it turns out that GA4 doesn't support the equivalent of UA search-and-replace filters, then a change in path of the published doc pages for this site might be in order. I'm still investigating this. Until a solution is found, we probably shouldn't register this site's page view with the unified GA4 web site tag.

/cc @alexmt @alexec

[chalin]

SO question: Write a search-and-replace filter in Google Analytics 4 (GA4)?

[chalin]

Related:

• Build fails in GitPod, from a fresh clone, including build-docs #11174
• [docs] deploy to gh-pages? #11175

[chalin]

Friendly ping @alexmt et al. Can someone update mkdocs-material to v7.1.8+? Also see the issues listed in the comment above. Thanks.

[chalin]

Btw, the Argo workflows website is built using v8.x of mkdocs_material: https://github.com/argoproj/argo-workflows/blob/1487bbc197a54a2e8caae4205aa98283583956f1/Makefile#L636-L637. If this repo could update to v8 as well, that would be grand, but I understand that that might be too big of a version jump (due to the possible breaking changes that might need to be addresses due to a major version increment).

[alexef]

@chalin see: #11248 as a starting point

[chalin]

Great, thanks @alexef! I'll track that PR.