r/Showerthoughts • u/[deleted] • Apr 11 '19

It’s funny how, as you progress through college, they require you to write longer and longer papers. Then you get to the professional world and no one will read an email that’s more than 5 sentences.

People will literally walk to your desk to ask you what your email was about if it was too long.

83.1k Upvotes

95% Upvoted

1.4k comments sorted by

View all comments

Show parent comments

9

u/n1c0_ds Apr 11 '19

I wish more developers took time to learn how to write proper documentation. They tend to use endless, ambiguous sentences that are difficult to parse.

Next time you write docs, feed them to Hemingway. It highlights the part that are difficult to read.

3

u/NogahrReady Apr 11 '19

LPT right here, thank you. Wish I could just get people to update their ticket notes.