Rewrite image-assurance, tutorials, users descriptions (CC next)#2719
Merged
Conversation
✅ Deploy Preview for calico-docs-preview-next ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview succeeded!Built without sensitive environment variables
To edit notification comments on pull requests, go to your Netlify project configuration. |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the description frontmatter across Calico Cloud “next” docs pages in three Cloud-only sections (image-assurance/, tutorials/, and users/) to provide consistent, product-specific meta descriptions.
Changes:
- Rewrote/added
descriptionfrontmatter in 11 Image Assurance pages. - Rewrote/added
descriptionfrontmatter in 27 Tutorials pages (including indexes and training primers). - Rewrote/added
descriptionfrontmatter in 4 Users & permissions pages (including the section index).
Reviewed changes
Copilot reviewed 42 out of 42 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| calico-cloud/image-assurance/index.mdx | Updated section index meta description for Image Assurance. |
| calico-cloud/image-assurance/creating-jira-issues-for-scan-results.mdx | Updated meta description for Jira issue creation workflow. |
| calico-cloud/image-assurance/exclude-vulnerabilities-from-scan-results.mdx | Updated meta description for excluding vulnerabilities. |
| calico-cloud/image-assurance/install-the-admission-controller.mdx | Updated meta description for admission controller install/config. |
| calico-cloud/image-assurance/set-up-alerts.mdx | Updated meta description for Image Assurance alerting. |
| calico-cloud/image-assurance/understanding-scan-results.mdx | Updated meta description for interpreting scan results. |
| calico-cloud/image-assurance/scanners/index.mdx | Updated scanners index meta description. |
| calico-cloud/image-assurance/scanners/overview.mdx | Updated meta description for scanner option comparison. |
| calico-cloud/image-assurance/scanners/cluster-scanner.mdx | Updated meta description for cluster scanner page. |
| calico-cloud/image-assurance/scanners/registry-scanner.mdx | Updated meta description for registry scanner page. |
| calico-cloud/image-assurance/scanners/pipeline-scanner.mdx | Updated meta description for pipeline/CLI scanner page. |
| calico-cloud/tutorials/index.mdx | Added/updated tutorials landing page meta description. |
| calico-cloud/tutorials/applications/index.mdx | Updated applications tutorials index meta description. |
| calico-cloud/tutorials/applications/egress-controls.mdx | Updated meta description for egress controls tutorial. |
| calico-cloud/tutorials/applications/ingress-microservices.mdx | Updated meta description for ingress microservices tutorial. |
| calico-cloud/tutorials/calico-cloud-features/index.mdx | Updated Calico Cloud features tutorials index meta description. |
| calico-cloud/tutorials/calico-cloud-features/tour.mdx | Updated meta description for web console tour tutorial. |
| calico-cloud/tutorials/calico-cloud-features/service-graph.mdx | Updated meta description for Service Graph tutorial. |
| calico-cloud/tutorials/calico-cloud-features/networksets.mdx | Updated meta description for network sets tutorial. |
| calico-cloud/tutorials/calico-cloud-features/projects.mdx | Updated meta description for projects tutorial. |
| calico-cloud/tutorials/calico-cloud-features/mylo-ai.mdx | Updated meta description for Mylo AI tutorial. |
| calico-cloud/tutorials/enterprise-security/index.mdx | Updated enterprise security tutorials index meta description. |
| calico-cloud/tutorials/enterprise-security/namespace-isolation.mdx | Updated meta description for namespace isolation tutorial. |
| calico-cloud/tutorials/enterprise-security/global-egress.mdx | Updated meta description for global egress tutorial. |
| calico-cloud/tutorials/enterprise-security/default-deny.mdx | Updated meta description for global default-deny tutorial. |
| calico-cloud/tutorials/enterprise-security/platform.mdx | Updated meta description for platform-tier controls tutorial. |
| calico-cloud/tutorials/kubernetes-tutorials/index.mdx | Updated Kubernetes tutorials index meta description. |
| calico-cloud/tutorials/kubernetes-tutorials/kubernetes-demo.mdx | Updated meta description for stars demo tutorial. |
| calico-cloud/tutorials/kubernetes-tutorials/kubernetes-network-policy.mdx | Updated meta description for Kubernetes network policy concepts tutorial. |
| calico-cloud/tutorials/kubernetes-tutorials/kubernetes-policy-basic.mdx | Updated meta description for basic policy tutorial. |
| calico-cloud/tutorials/kubernetes-tutorials/kubernetes-policy-advanced.mdx | Updated meta description for advanced policy tutorial. |
| calico-cloud/tutorials/training/index.mdx | Updated training primers index meta description. |
| calico-cloud/tutorials/training/about-networking.mdx | Updated meta description for networking primer. |
| calico-cloud/tutorials/training/about-network-policy.mdx | Updated meta description for network policy primer. |
| calico-cloud/tutorials/training/about-kubernetes-services.mdx | Updated meta description for services primer. |
| calico-cloud/tutorials/training/about-kubernetes-networking.mdx | Updated meta description for Kubernetes networking model primer. |
| calico-cloud/tutorials/training/about-kubernetes-ingress.mdx | Updated meta description for ingress primer. |
| calico-cloud/tutorials/training/about-kubernetes-egress.mdx | Updated meta description for egress primer. |
| calico-cloud/users/index.mdx | Added/updated users section index meta description. |
| calico-cloud/users/user-management.mdx | Updated meta description for roles/auth options reference. |
| calico-cloud/users/create-and-assign-custom-roles.mdx | Updated meta description for custom roles creation/assignment. |
| calico-cloud/users/create-custom-role-for-entra-id-group.mdx | Updated meta description for Entra ID group role binding. |
This was referenced May 12, 2026
Rewrites the `description` frontmatter field on all 42 unversioned Calico Cloud pages under image-assurance/, tutorials/, and users/. Each new description names "Calico Cloud", stays under 200 characters, avoids forbidden words (enable, disable, teaching), and uses the content-type lead-in from the docs-frontmatter-description skill (Step-by-step tutorial for ..., Reference ..., or action-led how-to). Tutorials are disambiguated from each other by feature, scenario, or outcome. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
42 mirror writes to calico-cloud_versioned_docs/version-22-2/: - image-assurance/ (11) - tutorials/ (27) - users/ (4) No drift either way. Vale clean on description lines. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2e747fa to
a0ecc8a
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.

Summary
Rewrites the
descriptionfrontmatter field on every page in three Calico Cloud-only trees, all undercalico-cloud/. 42 files, 1 line changed per file (frontmatter only).calico-cloud/image-assurance/calico-cloud/tutorials/calico-cloud/users/Next-only on purpose, Calico Cloud only — no versioned-mirror plans for OSS/CE. (
calico-cloud_versioned_docs/version-22-2/mirrors will follow in a separate, mechanical PR once all the next-tree descriptions are merged.)What every new description follows
Calico Cloud(canonical product name) in every description.docs-frontmatter-descriptionskill —Step-by-step tutorial for ...for tutorials,Reference ...for primers and indexes that act like reference, action-led for how-to pages.enable,disable, orteaching.Within-bucket disambiguation (tutorials)
The 27 tutorials cluster into five sub-themes — Kubernetes-tutorials, training primers, enterprise-security, applications, and Calico Cloud features. Each page within a sub-theme is varied along one or more of:
Reference primer for ...for the training/ pages that explicitly say they are not product-specific, vs.Step-by-step tutorial for ...for product-flow pages).Pre-fix violations found
descriptionfields (tutorials/index.mdx,users/index.mdx).kubernetes-tutorials/index.mdx= "Kubernetes tutorials and demos",calico-cloud-features/projects.mdx= "About projects").creating-jira-issues-for-scan-results.mdxhad "Creating Jira Issues for you scan results").create-custom-role-for-entra-id-group.mdxhadEntra ID, which renders correctly in body content but is awkward in a meta description).Calico Cloudin the description.enable/disable/teaching.Verification
Run from repo root on this branch:
Vale was run against the changed files; no new line-2 (frontmatter description) issues were introduced.
Test plan
llms.txtregeneration as follow-ups.🤖 Generated with Claude Code