Skip to content

Fix inline array example fence - #1777

Merged
BillWagner merged 1 commit into
dotnet:alpha-v12from
BillWagner:fix-v12-struct-heading-links
Aug 12, 2026
Merged

Fix inline array example fence#1777
BillWagner merged 1 commit into
dotnet:alpha-v12from
BillWagner:fix-v12-struct-heading-links

Conversation

@BillWagner

Copy link
Copy Markdown
Member

Summary

Fixes a Markdown structure defect that prevented bookmark generation for §16.7 and §16.8 sections.

Root Cause

The opening code fence in the blockquoted inline-array example (near line 557) was not blockquoted, while its closing fence was. This asymmetry caused Markdown parsing to swallow §16.7 through §16.8.8.2 as code content, preventing Docfx from generating anchors for these headings.

Changes

  • Prefix opening fence with blockquote marker (line 557): \\csharp → > \\csharp
  • Remove two now-visible excess blank lines before § 16.7

The fence is now balanced, restoring proper Markdown parsing.

Impact

Resolves 12 unique missing anchor targets across §16.7 and §16.8 sections. All current warnings in dotnet/docs#55428 related to structs.md headings are fixed.

Validation

  • standard/structs.md: markdownlint 0 issues (MD012 resolved)
  • All 57/57 physical headings parse as CommonMark headings
  • No broken anchor targets in standard/structs.md
  • git diff --check: passing

CI Note

Full standard/*.md markdownlint scan has 13 pre-existing base issues in attributes.md, classes.md, and variables.md on alpha-v12. This PR does not touch those files and does not introduce new issues.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 5324a812-2152-4917-8916-a73f37ba30a8
@BillWagner
BillWagner merged commit a827d02 into dotnet:alpha-v12 Aug 12, 2026
3 of 6 checks passed
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.

2 participants