Skip to content

[Privacy Pass] Fix docs style warnings and suggestions#32188

Draft
gsebb wants to merge 2 commits into
cloudflare:productionfrom
gsebb:privacy-pass-lint-fixes
Draft

[Privacy Pass] Fix docs style warnings and suggestions#32188
gsebb wants to merge 2 commits into
cloudflare:productionfrom
gsebb:privacy-pass-lint-fixes

Conversation

@gsebb

@gsebb gsebb commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Summary

Address linter warnings and suggestions across the Privacy Pass docs:

  • Remove contraction and trailing punctuation in headings
  • Capitalize Internet as a proper noun
  • Add Oxford comma
  • Replace 'see [link]' phrasing with 'refer to'
  • Replace directional wording with a direct reference

Additional changes:

  • Revert TypeScripts sample to just TypScript (no JS version to remove visual clutter)
  • Clarify architecture diagram in Getting Started

Documentation checklist

Address linter warnings and suggestions across the Privacy Pass docs:
- Remove contraction and trailing punctuation in headings
- Capitalize Internet as a proper noun
- Add Oxford comma
- Replace 'see [link]' phrasing with 'refer to'
- Replace directional wording with a direct reference
- Wrap the TypeScript sample in <TypeScriptExample> for an auto-generated JS tab
- Remove <TypeScriptExample> wrappers so TypeScript samples render as
  plain code blocks, consistent with the other code blocks in the docs
- Rework the 'maps to the four roles' example: split the interleaved
  diagram and code into a standalone boxed sequence diagram and a
  separate, annotated TypeScript block
- Clarify two step annotations in the example
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants