docs(operators): expand ATP and ATV on first use in registering-sequencer - #23254
Merged
Merged
Conversation
…ncer The `registering-sequencer.md` Prerequisites and Registration Steps sections reference "ATP/ATV tokens" without ever expanding either acronym. ATV is defined as "Aztec Token Vault" only in the sibling `staking-provider.md`; ATP is not defined anywhere in the docs tree. Concrete harm: Honk AI (the doc-grounded RAG bot on Discord) confidently hallucinated expansions "Aztec Productivity Token" and "Aztec Validation Token" when asked about tokenomics — neither exists — because those were the only plausible token-shaped expansions the model could synthesize from the bare letters. Other readers hitting these pages have the same ambiguity, just without the public hallucination. Fix: expand both acronyms on first use in each section (Prerequisites list and Registration Steps list), keep the bare form on subsequent lines so the doc stays readable. Applied to both `docs/docs-operate/...` (unversioned) and `docs/network_versioned_docs/version-v4.2.0/...` (rendered as v4.2.0 on docs.aztec.network). Opening as **draft** because ATP's expansion (per Aztec internal guidance: "Aztec Token Position") is not corroborated anywhere in this repo or in the on-chain Solidity (which uses the generic `stakingAsset` everywhere). Please confirm the expansion is correct, or correct me with the canonical full form, before merging. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
critesjosh
marked this pull request as ready for review
May 13, 2026 16:54
critesjosh
enabled auto-merge
May 13, 2026 16:54
alejoamiras
approved these changes
May 21, 2026
koenmtb1
approved these changes
May 21, 2026
critesjosh
added this pull request to the merge queue
May 21, 2026
AztecBot
pushed a commit
that referenced
this pull request
May 21, 2026
…ncer (#23254) Clarify docs so the LLMs don't get confused.
Collaborator
|
✅ Successfully backported to backport-to-v4-next-staging #23449. |
AztecBot
added a commit
that referenced
this pull request
May 22, 2026
aminsammara
added a commit
that referenced
this pull request
Jun 26, 2026
## Summary - Bumps v4 to 4.4.0 (version manifest was already set in a prior commit) - Adds 4.4.0 and 4.3.1 changelog entries covering all commits since v4.3.1 - Includes bug fixes for archiver, world-state, p2p, release-image, and mac install ## Changes included in 4.4.0 - fix(archiver): harden v4 L2 tips cache refresh (#24237) - fix(world-state): backport archive root guard (#24240) - fix(archiver): treat re-publish of preloaded protocol contracts as idempotent (#24227) - fix(p2p): guard ENR address parsing against malformed TCP fields (#24215) - fix(archiver): index zero-field logs under empty tag instead of throwing (#24212) - fix: released contract artifact aztec version (#23470) - fix(release-image): stamp aztec_version in published contract artifacts - fix: some mac install fixes (#20630) - feat(ci): run aztec-cli acceptance test on macOS (#23309) - fix(ci): skip aztec-cli notify job when acceptance test is skipped (#23534) - docs(operators): expand ATP and ATV on first use (#23254)
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
4 participants
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.
Clarify docs so the LLMs don't get confused.