docs(valkey): give the compatibility matrix heading an explicit anchor - #19
Merged
Conversation
doom lint's no-unmatched-anchor rule resolves a link fragment against the explicit ids a page declares, not against slugs derived from heading text, so the three links to release_notes.mdx#compatibility-and-support-matrix from installation.mdx, lifecycle_policy.mdx, and upgrade.mdx failed the docs pipeline. Declare the id the links already point at, using the escaped-brace heading form the sibling redis-docs repository uses. The rendered heading text is unchanged and the links stay as they were.
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.
Publishes the 2.0.0 release facts for Alauda Cache Service E2, which ships today on 2026-09-08 with a two-year lifecycle and support on Alauda Container Platform v4.2, v4.3, and v4.4.
Release facts published
Lifecycle dates follow the Alauda Cache Service E1 convention: release date plus one and two years, rounded to the end of that month.
lifecycle_policy.mdxnow carries the same four sections as E1 — version lifecycle timeline, release policy, support phases (Full Support in year one, Maintenance in year two), and maintenance policy — while keeping the Valkey-specific version dimensions and supported-version rule.Every "not yet published" and "next major release" placeholder is resolved:
lifecycle_policy.mdxrelease_notes.mdx## 2.0.0with the release dateintro.mdxinstallation.mdxupgrade.mdxlimitations.mdx2.0.0 has no predecessor product version, so
upgrade.mdxstates that the procedure applies from the next 2.0.x release onward and points new environments atinstallation.mdx. No 1.x rows, no 1.x-to-2.0.x upgrade path, and no fixed-issue / known-issue / security-fix sections.Correction: the 9.1 "packaging defect" warning
Five pages warned that the Helm Chart custom resource definition copy is stale and that a release package must install the canonical schema before 9.1 can be admitted. Verified at tag
v2.0.0:config/crd/bases/rds.valkey.buf.red_valkeys.yamlenumerates7.2/8.0/8.1/9.0/9.1;charts/valkey-operator/crds/rds.valkey.buf.red_valkeys.yamlenumerates only7.2/8.0/8.1— genuinely stale;d430d34, referenced by neither theMakefilenor.build/build.yaml..artifact/metadata.yamldeclarespackageType: OperatorBundle, andmake bundlegenerates the bundle fromconfig/manifests, which pullsconfig/crd/bases.So the warning pointed at a file customers never install. The narrative is removed; the installed-schema verification step stays, and the
8.0/9.0wording now matches the API comment at the shipped tag — admissible, no image shipped, usable only with a self-supplied image, neither supported nor tested. The stale chart copy is left alone here; it belongs invalkey-operator.Evidence ledger
Per the
CONTENT_AUDIT.mdreview rule, every new compatibility claim carries an evidence row:SOURCE_POLICY.md— the release facts recorded as evidence class 1 (product-owner requirements with no source-code evidence), the lifecycle date convention, the 2.x-only scope, and the corrected image baselinecf797832(which is7cb5874plus one Alpine bump, still building 7.2.14 / 8.1.9 / 9.1.1);CONTENT_AUDIT.md— updated P claim class, the rewritten 9.1 and 8.0/9.0 conflict rows, and rows for the five changed pages;ARCHITECTURE_FACTS.md— current-release wording, image baseline, and the chart CRD entry;TERMINOLOGY.md— Full Support, Maintenance, end of full support, end of maintenance, and Alauda Container Platform registered as canonical terms.The release candidate pinned in the
artifactsregistry,33812cb4, is an ancestor ofv2.0.0and differs from it only in theredis-exporterimage tag, so the schema and server-image claims hold for either commit.llms.txt
Regenerated for the 15 files whose sha256 no longer matched the index: the 6 pages in this change get new descriptions, the other 9 changed only by terminology edits after the index was last generated and keep theirs.
exclude_patternsin the state file still saiddocs/agent/**and is now aligned withllmstxt-config.yaml.Verification
yarn lintandyarn buildboth clean.Follow-ups, not in this change
masterneeds the same change as a separate branch.installation.mdxstill says "chart" twice, and its audit row cites Helm values and templates as evidence, for a page that ships as an OLM bundle. Re-deriving that page against the bundle is a separate task.how_to/30-upgrade.mdxis still unknown — an implementation gap, deliberately kept.valkey-operator/charts/valkey-operator/crds/should be regenerated or removed upstream.🤖 Generated with Claude Code