Skip to content

[docs-agent] Weekly style audit fixes 2026-07-29 - #1486

Open
alchemy-bot wants to merge 1 commit into
mainfrom
docs/weekly-style-audit-2026-07-29
Open

[docs-agent] Weekly style audit fixes 2026-07-29#1486
alchemy-bot wants to merge 1 commit into
mainfrom
docs/weekly-style-audit-2026-07-29

Conversation

@alchemy-bot

Copy link
Copy Markdown
Contributor

Weekly audit fixes for ERROR-level style violations found in PRs merged this week.

Files fixed

  • content/api-reference/data/webhooks/webhook-types/address-activity-webhook.mdx — hyphenate ERC20 / ERC721 / ERC1155 to ERC-20 / ERC-721 / ERC-1155 in prose (9 instances across the intro paragraph, the transfer-type table, and the field-descriptions table). Also fix a missing space between the backticked `token` and maps in the category field description.

Literal API enum values in backticks (`erc721`, `erc1155`, `erc20`) are preserved because those match the actual category field values the webhook emits.

Scope

Only ERROR-level terminology fixes on a live docs page whose file was modified in this week's merged set. Warning-level and style-preference issues were noted but skipped per the audit playbook.

Warning-level findings (not fixed — flagged for reference)

  1. content/changelog/2026-07-23.md line 6: single-instance on-chain state — single instance in a changelog bullet, stays WARNING per playbook.
  2. content/api-reference/alchemy-transact/transaction-simulation/*.mdx (six deprecated pages, deprecation date 2026-09-30): repeated ERC20/ERC721 in prose and Alchemy API Key in code comments. Skipped because the pages carry a deprecation notice — fixing terminology on soon-to-be-removed content adds churn.
  3. content/api-reference/data/webhooks/webhook-types/address-activity-webhook.mdx lines 40, 124, 173, 179: Title Case section headings (# Example Response, # Field Definitions, # Useful Endpoints, # How to Set-Up Address Activity Webhook). Match the existing legacy content/api-reference/ index-page pattern — WARNING per prior weekly-audit LEARNINGS, not fixed unilaterally on a single page.
  4. content/api-reference/data/webhooks/webhook-types/address-activity-webhook.mdx line 151: lowercase erc721 without backticks in prose — ambiguous between literal enum value (needs backticks) and prose (needs hyphen). Left alone.

Hyphenate ERC-20 / ERC-721 / ERC-1155 in address-activity-webhook.mdx prose to match STYLE_RULES.md preferred terminology. Also add a missing space between the backticked `token` and `maps` in the category field description.

Literal API enum values in backticks (`erc721`, `erc1155`, `erc20`) are preserved.

Scope: address-activity-webhook.mdx was modified in this week's PR #1443 and had 9 prose instances of ERC20/ERC721/ERC1155 (per-file repeat, ERROR-level per playbook).
@alchemy-bot
alchemy-bot requested a review from a team as a code owner July 29, 2026 17:22
@github-actions

github-actions Bot commented Jul 29, 2026

Copy link
Copy Markdown

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Jul 29, 2026, 5:23 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant