Skip to content

docs: fix inaccurate write-mode descriptions in README#4

Merged
mgiovani merged 1 commit into
mainfrom
docs/fix-upload-write-mode-wording
Jul 2, 2026
Merged

docs: fix inaccurate write-mode descriptions in README#4
mgiovani merged 1 commit into
mainfrom
docs/fix-upload-write-mode-wording

Conversation

@mgiovani

@mgiovani mgiovani commented Jul 2, 2026

Copy link
Copy Markdown
Owner

Summary

  • --print-only was documented as "no GitHub write," but upload_batch always creates a blob/tree/commit and pushes to refs/uploads/<issue|pr>/<n> regardless of write mode — only the comment/body step is skipped. Wording now reflects that.
  • --update-comment was documented as "append," but it does a full PATCH replace of the comment body (update_comment in src/git_data_api.rs). Wording now says "replace."

Testing

  • Live-verified both write modes against a real PR in this repo (PR docs: switch agent skill install to npx skills add #2): confirmed --print-only still writes a git ref, and --update-comment drops prior content instead of appending. Original PR body/comment state was restored after testing.
  • cargo test --release: 50 passed, 2 ignored (network-gated integration tests).

Live-tested each upload write mode against a real PR: --print-only
still creates a git blob/commit/ref (only the comment/body step is
skipped), and --update-comment replaces the comment body rather than
appending to it.
@mgiovani
mgiovani merged commit 047fec0 into main Jul 2, 2026
@mgiovani
mgiovani deleted the docs/fix-upload-write-mode-wording branch July 2, 2026 09:34
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