4 ms·
Author here. Happy to take any feedback or answer any questions about this post.
by mtlynch 2y ago
Author here.
Happy to take any feedback or answer any questions about this post.
- JohnFen 2y agoI basically agree with your viewpoint. The commit comment was almost great, but the inversion you describe is an issue. It's also really common. In all business and technical communications, it's best to make the first sentence or two the tl;dr bullet points (or the ask, if the communication is asking for someone to do something) and have the rest be the more detailed commentary.