Note that it'd be better if you update the diff when you update the documentation.

The command to do so:

arc diff --update <origin-diff-id> --head <commit-reference-start> <commit-reference-end>

• origin-diff-id would be one of D2140 (v1), D2223 (v2) in the current context.

I know it's more work on the user opening the diff.
But, this:

• avoids losing previous comments on the diff (@vlorentz and i did some on previous versions and i think i repeated some here)
• allows us, as reviewers, to see the multiple changes incrementally (if we so wish, through the history tab in the page, after the comments).

Another approach would be to push the version one at a time, then create new diff on top of it.
Ultimately making the new diff smaller and smaller ;)
Easing the review process.

Cheers,

I think you can close it now since i saw this commit rDDOCbc863ec6a56d539f57079b0b60e616a625c84f81

Initial commit pushed, comments pushed in followup 66b3e07ed9d9dbde2333cefe0e3375742dc76231 .