Review Pull Requests
Commentary's default workflow starts with a pull request URL.
Open A Review
- Copy a GitHub or Azure DevOps pull request URL.
- Open /.
- Paste the URL.
- Click
Open review.
Public GitHub PRs can open read-only without login. Private PRs and Azure DevOps routes require provider access.
Work In The Review Shell
- Use the file navigator to move between Markdown files.
- Use folder view when a PR changes several docs across directories.
- Stay in
Previewfor normal reading. - Switch to
Rawfor Markdown source context. - Start with
Latest, then useDiffwhen you need the change. - Use the change-set menu to review all changes or one commit.
- Use
Commentsto show or hide the thread rail.
Single-file Markdown PRs keep the shell tighter. Multi-file PRs show the file navigator.
Comment And Reply
Sign in before adding or replying to comments.
Once authenticated, you can:
- add a new thread from a rendered block
- select text and create a focused thread
- reply in the thread rail
- resolve or reopen threads
- keep pending PR threads staged until review submission
Submit The Review
On PR routes, Commentary stages pending review work locally until you click Submit review.
The submit dialog shows how many pending threads will sync before the provider review event is sent. Choose Comment, Approve, or Request changes, optionally add an overall summary, then submit.
Use Diff Intentionally
Diff is useful when you need to answer:
- What changed in this paragraph, table row, or section?
- Did this file change in a selected commit?
- Is the rendered change clearer than the raw Markdown?
For normal reading, Preview plus Latest is usually faster.