Skip to content

docs: refresh README to v0.6.5 surface, tighten CHANGELOG format#12

Merged
corvid-agent merged 1 commit into
mainfrom
chore/v0.6.5-docs-refresh
May 22, 2026
Merged

docs: refresh README to v0.6.5 surface, tighten CHANGELOG format#12
corvid-agent merged 1 commit into
mainfrom
chore/v0.6.5-docs-refresh

Conversation

@corvid-agent
Copy link
Copy Markdown
Contributor

Summary

The README had drifted — last meaningfully updated for v0.6.0, still mentioned the old `/tmp/fledge-gh-*` workspace location (changed in v0.6.5), and didn't document any of the write ops (`prs comment`/`review`/`merge`/`close`), the `repo` subcommand family (`file`/`clone`/`workspace`/`workspace-push`/`workspace-clean`), the `-R` flag, or `prs --head`.

Changes

README: rewrote to cover the full current surface as of v0.6.5. Each subcommand block lists actions + options + a few representative examples. New section: a worked example of the five-step edit-and-PR loop (`workspace` → edit → `workspace-push` → `prs create -H` → `workspace-clean`) so users can see how the pieces fit. Updated the "Hacking" note to reflect the current bin/ layout and the actual CI jobs.

CHANGELOG: kept the historical record intact (Keep a Changelog convention), but tightened formatting:

  • Em-dashes between version + date for consistency
  • Moved the v0.6.3 free-floating paragraph into a proper summary line above its bullets (previously broke the bullet-list format)
  • Reclassified v0.2.0/v0.2.1 "Other" bullets as Features / Fixes
  • Light prose tightening on v0.6.0 / v0.6.4 / v0.6.5 (content unchanged)

Test plan

  • README renders cleanly in GitHub's MD preview (checked locally)
  • No script changes — CI workflows (`bash -n`, `shellcheck`, `smoke --help`) are still relevant but don't gate this PR

README was stale at v0.6.0 — still mentioned `/tmp/fledge-gh-*` (changed
in v0.6.5) and didn't document any of the write ops (prs comment / review
/ merge / close), the `repo` subcommand family (file / clone / workspace
/ workspace-push / workspace-clean), the `-R` flag (added in v0.6.1),
or `prs --head` (v0.6.4). Rewrote it to cover the full current surface
and added a worked example of the five-step edit-and-PR loop so users
can see how the pieces fit together.

CHANGELOG: kept the historical record (Keep a Changelog convention),
but normalized the formatting — em-dashes between version + date,
moved the v0.6.3 free-floating paragraph into a proper summary line
above its bullets, lightly tightened v0.6.0 / v0.6.4 / v0.6.5 prose
without dropping any content. Also dropped the "Other" section in
v0.2.0/v0.2.1 by reclassifying its bullets as Features / Fixes.
@gemini-code-assist
Copy link
Copy Markdown

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@corvid-agent corvid-agent merged commit 346c4e5 into main May 22, 2026
5 checks passed
@corvid-agent corvid-agent deleted the chore/v0.6.5-docs-refresh branch May 22, 2026 01:13
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