Skip to content

Fix RST-to-Markdown conversion artifacts across English docs#8203

Merged
josbeir merged 2 commits into5.xfrom
fix-rst-conversion-artifacts
Jan 30, 2026
Merged

Fix RST-to-Markdown conversion artifacts across English docs#8203
josbeir merged 2 commits into5.xfrom
fix-rst-conversion-artifacts

Conversation

@dereuromark
Copy link
Copy Markdown
Member

Summary

Fixes ~100 RST-to-Markdown conversion artifacts across 45 English documentation files:

  • Replace all <span class="title-ref"> artifacts with backtick inline code (19 files)
  • Remove trailing : and .: RST directive colons (~40 instances across 19 files)
  • Remove orphan/True RST metadata from 404.md, epub-contents.md, pdf-contents.md
  • Remove leftover <div class="index"> and <div class="todolist"> blocks (14 blocks across 7 files)
  • Fix wrong code block language tags — css/javascript used for PHP code (5 files)
  • Fix escaped RST syntax (\*\*, =\>, \$, double backticks)
  • Fix broken :ref: link in 5-3-migration-guide.md
  • Fix broken RST cross-reference in console-commands/commands.md

- Replace all <span class="title-ref"> artifacts with backtick code
- Remove trailing ` :` and `.:` RST directive artifacts
- Remove orphan/True RST metadata from 404.md, epub-contents.md, pdf-contents.md
- Remove leftover <div class="index"> and <div class="todolist"> blocks
- Fix wrong code block language tags (css/javascript used for PHP code)
- Fix escaped RST syntax (\*\*, =\>, \\$, double backticks)
- Fix broken :ref: link in 5-3-migration-guide.md
- Fix broken RST cross-reference in console-commands/commands.md
@josbeir
Copy link
Copy Markdown
Contributor

josbeir commented Jan 30, 2026

Nice one

@LordSimal
Copy link
Copy Markdown
Contributor

0tWKgeSPHYygUDbZdA

@josbeir josbeir merged commit fb4bdec into 5.x Jan 30, 2026
5 checks passed
@josbeir josbeir deleted the fix-rst-conversion-artifacts branch January 30, 2026 08:17
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.

3 participants