docs: move the operator guides out of docs/ to where readers find them - #3780

What this PR does

Five documents under docs/ were operator facing guides written alongside the feature PRs that added the code, and left in the source tree where no user looks. They are on the website now, so this deletes them here and repoints every reference.

docs/oidc-tenant.md          -> kubernetes/oidc-authentication
docs/oidc-grafana.md         -> operations/services/monitoring/oidc-authentication
docs/gpu-vgpu.md             -> virtualization/vgpu
                              + operations/troubleshooting/gpu-operator-host-driver
docs/vm-external-vlan.md     -> networking/vm-external-vlan
docs/hubble-observability.md -> networking/hubble

docs/vm-external-vlan.md needed splitting, not moving. Its "Staging the reference CNI plugins" section is a contract, hack/cni-plugins-staging-contract.bats greps six literal sentences out of it and asserts them against the multus Dockerfile, the daemonset manifest and the platform values. That half is package documentation so it moves verbatim into a new packages/system/multus/README.md and the suite reads it there, the operator guide goes to the website. The bats messages name the README now, so a future failure points at the file that has to change.

References repointed in nine hand maintained files, two @param blocks, four template comments and three test comments. The seven generated files come from make generate with cozyvalues-gen v1.6.0, the version pinned in .github/workflows/pre-commit.yml, and each of them changed exactly one line.

Two changelog links in docs/changelogs/v1.6.0.md repointed as well. The wording is untouched, only the location of the documents it names has changed.

Two bits of process framing dropped on the way past, per #3777: bundles/system.yaml said GrafanaAdmin promotion was "out of scope for Phase 1" when it is simply not implemented, and the chainsaw suite pointed at "docs/oidc-tenant.md -> Phase 1".

Tests: 10 cni-plugins contract, 205 kubernetes chart, 11 multus chart, 9 monitoring chart, md-no-hardwrap.

Downstream repositories

• cozystack/website - follow-up: docs: import the operator guides that lived in the cozystack repo website#648 (the four guides), fix(monitoring): publish the Grafana OIDC guide in v1.6 website#647 (grafana guide made reachable in v1.6), docs(kubernetes): add OIDC authentication guide website#596 (tenant kubectl guide, rebased)

Walked the rest of the trigger map against the diff. No provider follow-up: both values.schema.json diffs are one description string each, with no field added, removed or renamed, no enum, no default, and no kind, plural or release.prefix change. packages/core/platform/values.yaml changed in a comment only and no key, so the hand written platform-package table on the site is unaffected.

Please merge after the website PRs, the @param URLs only resolve once those pages deploy.

Release note

docs: operator guides for tenant Kubernetes OIDC, Grafana OIDC, NVIDIA vGPU, VM external VLAN and Hubble now live on cozystack.io instead of the docs/ directory of this repository, and in-repo references point there. The CNI plugin staging contract that shared the VLAN guide moved to packages/system/multus/README.md.

Summary by CodeRabbit

• Documentation
  • Updated configuration and test references to link to the published Cozystack documentation.
  • Added Multus guidance covering staged CNI plugins, configuration, troubleshooting, and rollout behavior.
  • Removed outdated local guides for GPU/vGPU, Hubble observability, OIDC authentication, and external VM VLANs.
  • Clarified that server-level Grafana administrator promotion is not currently supported.