fix(about): resolve QA-rejected issues across 6 About section pages#864
Merged
DeveloperAlly merged 4 commits intodocs-v2from Apr 7, 2026
Merged
Conversation
- livepeer-overview.mdx: fix typo 'incenticises' → 'incentivises'; remove <expandable 'Old notes'> section containing exposed internal placeholder text - mental-model.mdx: remove exposed '<Note> image would be good </Note>' internal design note - livepeer-token.mdx: remove #TODO, #MOVE THESE, #REVIEW markers and <Danger> internal editorial note box - compendium/livepeer-glossary.mdx + x-deprecated/livepeer-glossary.mdx: remove exposed '<Note> A Searchable view would be ideal here</Note>' and '## ====' markdown-leak heading; fix banned-phrase 'etc.' lint errors in pre-existing copy" Agent-Logs-Url: https://github.com/livepeer/docs/sessions/1a43c7a2-5295-463d-875c-0e4a2777c603 Co-authored-by: DeveloperAlly <12529822+DeveloperAlly@users.noreply.github.com>
Agent-Logs-Url: https://github.com/livepeer/docs/sessions/1a43c7a2-5295-463d-875c-0e4a2777c603 Co-authored-by: DeveloperAlly <12529822+DeveloperAlly@users.noreply.github.com>
Agent-Logs-Url: https://github.com/livepeer/docs/sessions/1a43c7a2-5295-463d-875c-0e4a2777c603 Co-authored-by: DeveloperAlly <12529822+DeveloperAlly@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Fix broken links and typos in About section
fix(about): resolve QA-rejected issues across 6 About section pages
Apr 7, 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
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.
Six pages in the About section were rejected in QA review for exposing internal editorial notes, placeholder text, broken markers, and a markdown-leak heading. This PR resolves all identified issues.
Description
Removes all user-visible internal content from the About section pages flagged in QA review. No content rewrites — surgical removal of draft artefacts only.
Changes by file
v2/about/concepts/livepeer-overview.mdx— Fixed typoincenticises→incentivises; removed<expandable title="Old notes">block containingINSERT LIVEPEER ACTOR DIAGRAM HEREplaceholder note and old draft actor descriptionsv2/about/concepts/mental-model.mdx— Removed<Note> image would be good </Note>which was rendering as the first visible element on the pagev2/about/protocol/livepeer-token.mdx— Removed#TODOfrom four section headings (Rewards Distribution, Governance, Treasury, Technical Mechanics); removed<Danger>box exposing"Move majority of this to token section…"; removed#MOVE THESEand#REVIEWinline markers; removed the unwritten "Economic Flow Diagrams" stub sectionv2/about/resources/compendium/livepeer-glossary.mdx+v2/about/resources/x-deprecated/livepeer-glossary.mdx— Removed<Note> A Searchable view would be ideal here </Note>; removed## ====heading that was leaking into the "On this page" sidebar; fixed three pre-existingetc.banned-phrase copy-lint blocking errors in both filesv2/about/portal.mdx— No change; Whitepaper card link already correctly targets/v2/about/resources/knowledge-hub/livepeer-whitepaperScope
In scope:
v2/about/concepts/livepeer-overview.mdxv2/about/concepts/mental-model.mdxv2/about/protocol/livepeer-token.mdxv2/about/resources/compendium/livepeer-glossary.mdxv2/about/resources/x-deprecated/livepeer-glossary.mdxOut of scope: No routing changes, no frontmatter edits, no component changes.
Validation
Parallel validation: Code Review ✅ · CodeQL ✅
Follow-up Tasks
WEAKENED_VALUEcopy warnings inlivepeer-overview.mdxare pre-existing and flagged for human sign-off per lint policy — not introduced by this PR.Type of Change
Related Issues
Related to #
Changes Made
#TODO,#REVIEW,#MOVE THESEmarkers rendering as visible body text inlivepeer-token.mdx<Danger>box with internal editorial instruction fromlivepeer-token.mdx<Note>and<expandable>blocks containing internal design/placeholder notes fromlivepeer-overview.mdxandmental-model.mdx## ====markdown-leak heading and internal<Note>from both glossary filesincenticises→incentivisesTesting
npm run devChecklist
Governance Approval
Not required for this PR.
Copy Governance Gate - L5
Auto-checked by CI (lint-copy.js + lint-structure.js)
{/* REVIEW: */}flags in rendered contentpageType,audience,lastVerifiedpresent in frontmatterHuman review required
Sequence (L2)
Completeness (L3)
Tone (L4)
Brief compliance
Warning
Firewall rules blocked me from connecting to one or more addresses (expand for details)
I tried to connect to the following addresses, but was blocked by firewall rules:
edgedl.me.gvt1.com/home/REDACTED/work/_temp/ghcca-node/node/bin/node node install.mjs(dns block)If you need me to access, download, or install something from one of these locations, you can either: