https://lightfactory.app/blog/ Recent content in Blog on Lightfactory Hugo en Mon, 02 Nov 2026 00:00:00 +0000 https://lightfactory.app/blog/what-a-review-reads/ Mon, 02 Nov 2026 00:00:00 +0000 https://lightfactory.app/blog/what-a-review-reads/ <p>A diff shows what changed. It rarely shows why the code was shaped the way it was. That knowledge usually lives in a module README or a decision record that the change never touches, so a reviewer who reads only the diff cannot tell when a change quietly breaks an agreement.</p> <h2 id="the-diff-first-then-the-documents-behind-it">The diff first, then the documents behind it</h2> <p>Lightfactory starts with the diff of the pull request. It then reads the README of each module the change touches and the decision records those READMEs link to. A finding cites the document it relies on, for example:</p>