docs(operators): expand ATP and ATV on first use in registering-sequencer#23254
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>
alejoamiras
approved these changes
May 21, 2026
koenmtb1
approved these changes
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
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.