PR Story (alpha)
Read a large pull request as chapters with cited code. A secondary, alpha feature that is separate from benchmarks.
Status: alpha. PR Story is built and tested, but it is not released beyond the private preview yet. It is separate from benchmarks and does not affect benchmark results.
What it does
PR Story turns an open pull request into a short story you can review by chapter. Each chapter groups one part of the change, explains it, and links to the exact lines it is based on. Fullbeam saves which chapters you reviewed, so a new push only asks you to look again at what changed.
To try it without connecting anything, open the public sample. It uses synthetic data, not a real customer repository.
Before you start
- Connect GitHub. After installing, Fullbeam prepares stories for up to five open pull requests.
- You can only open stories for repositories your GitHub account can access.
Steps
- Open Overview. Recent pull requests appear there once GitHub is connected. Open one to see its Story. (PR Story is not in the sidebar.)
- Read the summary at the top first.
- Open each chapter. Read the explanation and follow the cited lines in the diff.
- Select Mark reviewed when you have checked a chapter's code. This saves your checkpoint. It does not approve the pull request.
- When you are done, select Finish review on GitHub and approve or request changes in GitHub's own review dialog.
What you'll see
- Risk tags on each chapter: Safe to skim or Inspect carefully. They help you decide where to spend time. They are not approvals.
- After a new push, chapters are marked Reviewed, Previously inspected or Re-review. Use Check for updates to load the latest revision.
- On GitHub, a Fullbeam Review check and one summary comment that is updated in place instead of a new comment on every push.
Limits
- Alpha. Publishing the check and comment is still being verified against production GitHub.
- A story leaves out routine details on purpose. The full diff is always there beside each chapter.
- PR Story does not approve, request changes on, or merge pull requests.