Skip to content

docs(style[shell]): Standardize shell code blocks#517

Merged
tony merged 3 commits intomasterfrom
docs-cmd-cleanup
Mar 15, 2026
Merged

docs(style[shell]): Standardize shell code blocks#517
tony merged 3 commits intomasterfrom
docs-cmd-cleanup

Conversation

@tony
Copy link
Copy Markdown
Member

@tony tony commented Mar 15, 2026

Summary

  • Add shell command formatting rules to AGENTS.md (console tag, $ prefix, line continuations)
  • Standardize all shell code blocks in README.md and CHANGES

Changes

  • AGENTS.md: Add "Shell Command Formatting" section, update "Code Blocks" multi-command guidance
  • README.md: Fix bashconsole tags, add $ prefix
  • CHANGES: Fix shconsole tags, add $ prefix

tony added 2 commits March 15, 2026 04:50
why: Standardize shell code blocks for copy-pastability and readability
what:
- Add console language tag + $ prefix rule
- Add line continuation rule for wide multi-flag commands
- Scope to documentation shell examples, not doctests
why: Improve copy-pastability and readability of shell examples
what:
- Ensure all shell blocks use console tag with $ prefix
- Fix README.md installation examples
- Fix CHANGES shell examples
@codecov
Copy link
Copy Markdown

codecov bot commented Mar 15, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 58.99%. Comparing base (fb1d763) to head (1b240ab).
⚠️ Report is 1 commits behind head on master.

Additional details and impacted files
@@           Coverage Diff           @@
##           master     #517   +/-   ##
=======================================
  Coverage   58.99%   58.99%           
=======================================
  Files          41       41           
  Lines        6457     6457           
  Branches     1082     1082           
=======================================
  Hits         3809     3809           
  Misses       2126     2126           
  Partials      522      522           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

why: Apply the line-splitting rule from Shell Command Formatting guidelines
what:
- Split ruff check compound command in CHANGES
@tony tony marked this pull request as ready for review March 15, 2026 11:07
@tony tony merged commit 2469d42 into master Mar 15, 2026
7 checks passed
@tony tony deleted the docs-cmd-cleanup branch March 15, 2026 11:44
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.

1 participant