Skip to content

docs(dotnet,xamarin): fix raw HTML leftover breaking network.md rendering - #42

Merged
krassx merged 1 commit into
bugsee:mainfrom
fishmanalex:fix/raw-html-network-pages
Sep 5, 2026
Merged

docs(dotnet,xamarin): fix raw HTML leftover breaking network.md rendering#42
krassx merged 1 commit into
bugsee:mainfrom
fishmanalex:fix/raw-html-network-pages

Conversation

@fishmanalex

Copy link
Copy Markdown
Contributor

Summary

  • docs/sdk/dotnet/network.md and docs/sdk/xamarin/network.md both embedded a pre-rendered HTML fragment left over from the old MkDocs migration inside a :::warning admonition, instead of a plain markdown code span.
  • Confirmed in the actual production build: it split the sentence into a standalone block-level code box mid-paragraph, auto-linked the placeholder https://domain.com as a real clickable hyperlink, and left malformed nesting (<p></div></div>) that Docusaurus's build flags as an HTML validation error (No "p" element in scope but a "p" end tag seen).
  • Replaced the raw HTML with a plain markdown inline code span: `new HttpWebRequest("https://domain.com")`.

Test plan

  • npx cspell "docs/**/*.md" "docs/**/*.mdx" --no-cache -c cspell.json — 0 issues across 288 files
  • npm run build — succeeds with no HTML validation warnings (previously flagged this exact fragment)
  • Spot-check both pages render correctly on the live site after merge/deploy

🤖 Generated with Claude Code

https://claude.ai/code/session_01QnXDhVitCVmMNafPRvKUat

…ring

Both pages embedded a pre-rendered HTML code fragment from the old MkDocs
migration inline in a warning admonition instead of a markdown code span.
It broke the sentence into a standalone block-level code box, auto-linked
the placeholder https://domain.com as a real hyperlink, and left malformed
nesting that Docusaurus's build flags as an HTML validation error
("No p element in scope but a p end tag seen"). Replaced with a plain
markdown inline code span.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@krassx
krassx merged commit 357e691 into bugsee:main Sep 5, 2026
1 check 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