Skip to content

[docs] docs: tighten markdown reference guidance#47170

Merged
pelikhan merged 1 commit into
mainfrom
docs/unbloat-markdown-8418408929a68519
Jul 22, 2026
Merged

[docs] docs: tighten markdown reference guidance#47170
pelikhan merged 1 commit into
mainfrom
docs/unbloat-markdown-8418408929a68519

Conversation

@github-actions

@github-actions github-actions Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Editorial pass over docs/src/content/docs/reference/markdown.md to tighten prose and improve clarity throughout the markdown reference guide.

Changes

File Type Notes
docs/src/content/docs/reference/markdown.md modified Prose rewrites for concision and active voice

Details

docs/src/content/docs/reference/markdown.md
  • Removed subjective framing from the intro paragraph; replaced with a direct description.
  • Tightened Writing Effective Instructions: condensed sentence structure, formatted example verbs as inline code.
  • Rephrased error-handling guidance to use imperative voice.
  • Changed "consistent output" to "repeated output shapes" for precision.
  • Simplified the Common Pitfalls list items.

Impact

  • Breaking change: No
  • Scope: Documentation only
  • Behaviour change: None — all substantive content preserved; changes are editorial only.

References: §29894884130

Generated by PR Description Updater for #47170 · sonnet46 18.2 AIC · ⌖ 4.53 AIC · ⊞ 4.8K ·

@pelikhan
pelikhan marked this pull request as ready for review July 22, 2026 05:49
Copilot AI review requested due to automatic review settings July 22, 2026 05:49
@pelikhan
pelikhan merged commit ad6839b into main Jul 22, 2026
1 check passed
@pelikhan
pelikhan deleted the docs/unbloat-markdown-8418408929a68519 branch July 22, 2026 05:49
@github-actions

github-actions Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor Author

Test Quality Sentinel completed test quality analysis.

No test files were added or modified in this PR. Test Quality Sentinel skipped.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Condenses markdown workflow guidance while preserving examples, security guidance, and core instructions.

Changes:

  • Tightens introductory and writing guidance.
  • Simplifies organization, failure-handling, and pitfalls prose.
Show a summary per file
File Description
docs/src/content/docs/reference/markdown.md Clarifies and shortens markdown authoring guidance.

Review details

Tip

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

  • Files reviewed: 1/1 changed files
  • Comments generated: 0
  • Review effort level: Medium

@github-actions

Copy link
Copy Markdown
Contributor Author

🎉 This pull request is included in a new release.

Release: v0.83.0

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation doc-unbloat documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants