Skip to content

docs(readme): rewrite for standard-readme compliance#3

Merged
dacrystal merged 1 commit intomainfrom
docs/readme-standard-readme-compliance
Apr 7, 2026
Merged

docs(readme): rewrite for standard-readme compliance#3
dacrystal merged 1 commit intomainfrom
docs/readme-standard-readme-compliance

Conversation

@dacrystal
Copy link
Copy Markdown
Owner

Summary

  • Move banner before badges, add Table of Contents (required for docs > 100 lines)
  • Rename sections to match spec: Why devcode?Background, Command ReferenceAPI, File Injection (cp)File Injection
  • Split Quick Start into Install (with Prerequisites) + Usage (with subsections folded in)
  • Add required Contributing section; add license owner attribution

Spec

Follows standard-readme section order and requirements exactly.

Test Plan

  • All 9 ToC anchors resolve to actual headings
  • Banner appears before badges
  • ## License is the final section
  • 184 tests passing (pytest)

- Move banner before badges (spec order: title → banner → badges)
- Add Table of Contents (required for docs > 100 lines)
- Rename sections: Why devcode? → Background, Command Reference → API,
  File Injection (cp) → File Injection
- Split Quick Start into Install (with Prerequisites) and Usage sections
- Fold Typical Workflow, Project Switching, Advanced Options, Internal Flow
  into Usage as subsections
- Remove redundant Core Concepts section
- Add Contributing section (required by spec)
- Add license owner: MIT © Nasser Alansari (dacrystal)
@codecov-commenter
Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.86%. Comparing base (f4c755d) to head (cb1e7bf).
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files
@@           Coverage Diff           @@
##             main       #3   +/-   ##
=======================================
  Coverage   93.86%   93.86%           
=======================================
  Files           1        1           
  Lines         554      554           
=======================================
  Hits          520      520           
  Misses         34       34           

☔ 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.

@dacrystal dacrystal merged commit 95bf371 into main Apr 7, 2026
3 checks passed
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.

2 participants