Normalize wiki Markdown structure - #8
Conversation
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 0a0a2be049
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| --- | ||
|
|
||
| ## Where VoteMilestones are configured | ||
| ### Where VoteMilestones are configured |
There was a problem hiding this comment.
Restore level-two milestone sections
Promote the page-level sections back to ##: the page now jumps directly from its H1 to this H3, and the same blanket demotion later makes Legacy migration and Placeholders children of the Examples section. This produces an inaccurate document outline and generated table of contents for navigation and screen-reader users; only actual subsections such as individual examples should remain at H3.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Addressed in 3afbe63: the page-level VoteMilestones sections, including Legacy migration and Placeholders, are restored to H2 while individual examples remain H3.
| --- | ||
|
|
||
| ## Location | ||
| ### Location |
There was a problem hiding this comment.
Promote Location to a level-two heading
Change Location back to ## Location. It is a standalone page section immediately beneath the H1, so demoting it to H3 creates an H1-to-H3 level skip before the later H2 sections and leaves the generated outline structurally inconsistent.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Addressed in f904cf8: Location is restored to an H2 section.
|
@codex review The two previous heading findings were addressed in |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: f904cf8ccc
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| dateCreated: 2025-08-30T22:18:22.882Z | ||
| --- | ||
|
|
||
| # Rewards |
There was a problem hiding this comment.
Promote the introductory Rewards headings
Adding this page title leaves the document jumping directly from H1 to the H3 headings at lines 13, 21, and 36, even though these introduce top-level sections before the later H2 sections. This produces an inconsistent generated outline for navigation and screen-reader users; promote those introductory sections to H2 (and remove the empty H2 at line 64) so their subsections can remain beneath them.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Addressed in f1dbd22: the three introductory sections are now H2, the empty H2 was removed, and Placeholders is an H2 so it is not incorrectly nested under reward-file listing.
|
@codex review The latest |
|
Codex Review: Didn't find any major issues. Keep it up! Reviewed commit: ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
If Codex has suggestions, it will comment; otherwise it will react with 👍. Codex can also answer questions or update the PR. Try commenting "@codex address that feedback". |
What changed
AdvancedPriority-Rewards.mdWhy
Wiki.js front matter hides several structural problems that become visible in repository, GitHub Wiki, accessibility, and generated-site contexts. Consistent heading hierarchy also makes long pages easier to navigate and parse.
The API and Special Rewards pages are intentionally excluded here because pull request #7 rewrites them and supplies their corrected H1 structure.
Validation
git diff --checkpassed locally