I really appreciate this detailed explanation. I definitely don't want to fall into the trap of writing docs that are only understandable by me. So I will follow the steps for the first draft. Then I ask the person who will do our code review if they will be open to give us feedback on our docs also.
We're a place where coders share, stay up-to-date and grow their careers.
We strive for transparency and don't collect excess data.