> The documentation comments gets nitpicked to death with mostly useless comments about not having periods at the ends of lines
> End up having to explain every little detail throughout the function
For these cases I like to use the ‘suggest an edit’ feature on gitlab/github. Can have the change queued up in the comments and batch commit together, and takes almost no additional time/effort for the author. I typically add these suggestion comments and give an approve at the same time for small nitpicks, so no slow down in the PR process.