On Sun, Mar 24, 2024 at 10:55 AM Phillip Wood <phillip.wood123@xxxxxxxxx> wrote: > 5 - documentation updates > I'm on the fence about having these in a separate commit like the > current patch 5 or updating the documentation when the code is > changed. It's generally more reviewer-friendly to bundle documentation change into the patch which changes the observable behavior. This way, a reviewer has the behavior change fresh in mind and can verify that the revised documentation matches the new implementation. Same goes for revising tests in the same patch which changes behavior (though, of course, revising tests at the same time as the change of behavior is also mandatory for maintaining bisectability).
