Skip to content

Update documentation guide for VitePress and Markdown#8161

Merged
LordSimal merged 4 commits into5.xfrom
rewrite-documentation-instructions
Jan 27, 2026
Merged

Update documentation guide for VitePress and Markdown#8161
LordSimal merged 4 commits into5.xfrom
rewrite-documentation-instructions

Conversation

@josbeir
Copy link
Copy Markdown
Contributor

@josbeir josbeir commented Jan 27, 2026

Migrates contributing documentation from ReStructuredText/Sphinx to Markdown/VitePress.

Changes

  • Updated all .rst references to .md
  • Replaced ReST syntax guide with Markdown/VitePress guide
  • Removed Sphinx-specific sections (PHP domain directives, :orphan:, :noindex:)
  • Added VitePress features: frontmatter, custom containers, code highlighting
  • Updated links to VitePress Guide and Markdown Guide

Copilot AI review requested due to automatic review settings January 27, 2026 07:15
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request successfully migrates the documentation contribution guide from ReStructuredText/Sphinx to Markdown/VitePress, aligning with the project's transition to a modern documentation stack.

Changes:

  • Updated all file extension references from .rst to .md throughout the guide
  • Replaced ReST-specific syntax documentation with comprehensive Markdown/VitePress guides
  • Removed Sphinx-specific features (PHP domain directives, :orphan:, :noindex:)
  • Added VitePress-specific features including frontmatter, custom containers, code highlighting with line numbers, and enhanced link handling

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/en/contributing/documentation.md Outdated
Comment thread docs/en/contributing/documentation.md Outdated
josbeir and others added 2 commits January 27, 2026 08:50
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@LordSimal LordSimal merged commit 57b923d into 5.x Jan 27, 2026
@LordSimal LordSimal deleted the rewrite-documentation-instructions branch January 27, 2026 17:54
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