Merged
Conversation
Convert all documentation files from Texy format (.texy) to standard Markdown (.md). Texy-specific syntax (link formats, code block delimiters, image embeds, heading styles) has been translated to their Markdown equivalents.
There was a problem hiding this comment.
Pull request overview
Migrates the project documentation in doc/ from Texy-style markup to GitHub-renderable Markdown, updating headings, links, code fences, and image embeds.
Changes:
- Converted Texy-style headings and annotations to Markdown heading syntax across docs.
- Replaced Texy code blocks (
/-- ... \--) with fenced Markdown code blocks (including language tags where applicable). - Migrated Texy link/image syntax to standard Markdown links and images; replaced
menu.texywithmenu.md.
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| doc/symfony-console.md | Converted headings and code blocks to Markdown. |
| doc/symfony-bundle.md | Converted headings, code fences (PHP/YAML), and internal link to Markdown. |
| doc/plain-php.md | Converted code fencing and image embed to Markdown. |
| doc/nette-extension.md | Converted headings, code fences, and external/internal links to Markdown. |
| doc/menu.texy | Removed legacy Texy menu. |
| doc/menu.md | Added Markdown menu with updated intra-doc links. |
| doc/default.md | Converted headings, rules, and code blocks to Markdown; updated link syntax. |
Comments suppressed due to low confidence (3)
doc/nette-extension.md:12
- The fenced block is marked as
yaml, but the example uses tab indentation. YAML disallows tabs for indentation, so readers copying this may get invalid YAML. Consider converting tabs to spaces, or change the fence language to something accurate for Nette config (e.g.,neon/text).
doc/nette-extension.md:36 - Same as above: this block is labeled
yaml, but it contains tab-indented config (and placeholders) that won't validate as YAML. Either convert indentation to spaces (valid YAML) or switch the code fence language to match the intended format.
doc/default.md:58 - Grammar: “Migrations can written as file …” is missing words and reads awkwardly. Consider rewriting (e.g., “Migrations can be written as files …”) to avoid confusing readers during the format migration.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
composer.json requires symfony/* ^4.4, so the app/AppKernel.php registration path for Symfony < 4 is no longer applicable.
- Fix subject-verb agreement ("Nextras Migrations ships/defines/comes")
- Add missing articles (a/the) throughout
- Fix missing "be" in "can be written"
- Add missing commas after introductory phrases
- Fix "options" → "option" (singular)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
.texy) to standard Markdown (.md)"text":urllinks,/-- \--code blocks,[* image *]embeds, underline headings,.[h4]annotationsTest plan
.mdfiles render correctly on GitHubplain-php.mddisplays correctly