Also, practice. Keep writing. Write postmortems, discovery docs, blog posts, threaded tweets. Practice in multiple mediums and find your style.
One last bit of unsolicited advice: your job is writing. This is the best writing book I've ever read that deals with the issues I saw in your writing: https://www.amazon.com/Writing-Well-Classic-Guide-Nonfiction...
You can tell the author knows what they're talking about because the book is a really easy read!
Honestly there isn't anything that you couldn't get by simply reading and applying the advice from "The Elements of Style" by Strunk and White[1] and "On Writing Well" by Zinsser [2].
The primary philosophy is that if you can't write well, then you haven't thought it through. The act of writing is an act of reasoning.
0. Practice in a strong feedback loop. This applies for anything, not just writing.
1. Ruthlessly reduce your sentences. Repeat until you can't eliminate or combine any more words.
2. Avoid adverbs. Use "dashed" or "sprinted" instead of "ran quickly". Learn more words.
3. Avoid weasel words like "should" "could" "might". Take a stance and give concrete reasons.
4. Use concrete data over descriptors. "+5% profit" over "increased profit".
5. Write in active voice. Look up the "by Zombies" trick.
6. Use the simplest word that maintains your meaning. No one needs to use the word "utilize".
[1]: https://www.amazon.com/Elements-Style-Fourth-William-Strunk/...
[2]: https://www.amazon.com/Writing-Well-Classic-Guide-Nonfiction...
https://www.amazon.com/Writing-Well-Classic-Guide-Nonfiction...
For the second advantage it depends where you want to do. If you want to stay a dev and only code then the best thing to do is to master your stack and learn complex things. By doing that you differentiate yourself and increase the barrier of entry. So for instance to learn C++, AWS, Machine Learning, Hadoop ecosystem, webgl... Depending your field and what can be the next big hard thing with it.
Else, the other way is to go up in the hierarchy to be a team leader and maybe to go higher. At first you have been (or should) start to learn how to manage people. You should know how to lead your team when things are doing well but also when things are at the worst. Sometimes you have deadlines that are hard to meet. Sometimes the stress is at the maximum, financially the company is not doing well, or goals and ideas diverge... It's all the experience you need to get to be able to manage these situations and start to be a great leader.
Also you -may- start to learn to master git to be a team leader, to be able to fix the problems, and manage the repo for the code reviews. Another point should be to increase your communication skill, every day by talking with your team, by enjoying to write well written emails and speeches. These books [1] are a good start. And also a last point that I think is important is to start to get financial skills with things like financial management, accounting, and if possible to be able to do simple DCFs...
[1] http://www.amazon.com/Elements-Style-4th-William-Strunk/dp/0...
http://www.amazon.com/Writing-Well-30th-Anniversary-Nonficti...
http://www.amazon.com/Pitch-Anything-Innovative-Presenting-P...
If the idea you note down is any good today, it'll be a good idea tomorrow too. And a year from now.
If you have enough good starting points, actually spending some time writing out an essay from them becomes easier. Remember you'll probably want to do at least three re-writes if you're hoping the result is going to be any good. Lots of people don't do that -- and it shows. Most half-decent blog posts would've been a lot better if the authors took the time to rework them a bit more. Or, according to Hemmingway: "“The first draft of anything is shit.”
So with the caveat that I don't actually write much (yet?), the best book I've read on writing is: William Zinsser's "On Writing Well": http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...
Highly recommended for anyone that have to communicate in writing (ie: everyone).
> I don't have anything to say to people who know less than me, because explaining obvious things seems boring, and I don't know what to say to people on HN/LessWrong, because I feel like they are smarter than me and already know everything I am about to say.
For essays, it can be good to write for yourself. To yourself, or someone much like yourself, but someone who's perhaps not yet encountered one particular idea, one particular technique -- one particular subject.
That usually gives a good framework for avoid "talking down". Write to yourself of one, two or five years ago. There will be many that don't have that last year, years of experience and circumstance that led you down the path to were you are now. Perhaps such a perspective makes it easier for you to share something?
[c] http://www.colornote.com/download.html
I mostly use Colornote to keep track of ideas, such as app/application/project ideas along with a couple of bulletpoints (eg: Reinvent email: look into alternative client/server sync such as jmap; store email in normalized sql db?; document db?; store attachments based on content hash? (free de-dup); Store email body as same? (Good for multi-user server support for mailinglists ... etc))
It's absolutely the best book for anybody who keeps a blog or writes any sort of non-fiction. I try and re-read it once a year.
1. http://www.amazon.com/Writing-Well-30th-Anniversary-Nonficti...
2. Watch the video at the end of this link: http://fivethirtyeight.com/features/watch-me-write-this-arti... The take away is write, rewrite, rewrite, rewrite, and rewrite some more.
3. Pay attention to the people who write well in your life. When you read an email that feels well written try to figure out why you like it. And use those elements in your future writings.
http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...
http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...
http://www.amazon.com/The-Curious-Case-Misplaced-Modifier/dp...
Here's the amazon link: http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...
Just like coding, the "shortest" path to becoming a good writer is practice - practice everyday.
http://www.amazon.com/Writing-Well-30th-Anniversary-Nonficti...
It has plenty of examples and advice on various types of writing.
Beyond that, my advice is to simply read good texts. One starting point would be:
http://www.amazon.com/American-Essays-Charles-B-Shaw/dp/B000...
Or, for something newer:
http://brevity.org/misc/bestswi.html
While doing a quick search, I also came across this:
http://blogs.law.harvard.edu/philg/2009/05/20/need-examples-...
Which seems to be a great starting point.
http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...
http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...
http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...
I agree with that statement. I also suggest the book, "On Writing Well." It helped me greatly with writing.
http://www.amazon.com/Writing-Well-30th-Anniversary-Nonficti...
On Writing Well - http://www.amazon.com/Writing-Well-30th-Anniversary-Nonficti...
The Artful Edit - http://www.amazon.com/Artful-Edit-Practice-Editing-Yourself/...
http://www.amazon.com/Writing-Well-30th-Anniversary-Nonficti...
It's slightly amusing that the first sentence of the linked article is grammatically incorrect: "How to make engineers write concisely with sentences?" is not a question despite the question mark. The second sentence is overly long and uses three commas to give the reader breathing space.
1999 edition on Amazon: http://www.amazon.com/Elements-Style-Fourth-William-Strunk/d...
1918 edition online: http://www.bartleby.com/141/
For more hand-holding, On Writing Well by William Zinsser is worthwhile.
Amazon: http://www.amazon.com/Writing-Well-30th-Anniversary-Nonficti...
This is the theory of William Zinsser's On Writing Well (http://www.amazon.com/Writing-Well-30th-Anniversary-Nonficti...).
It's one of my favorite books and its primary point is that verbosity is the enemy of clarity and therefore the clearest sentence is also the smallest one. I think that concept is a 1,000 times more important than having perfect grammar.
Oh, and to bring this back to tech, I think this concept is even more important given the sheer amount of data available to use today. Everyone should be trying to write as succinctly as possible just so their readers can fit it all in.
http://www.amazon.com/Writing-Well-30th-Anniversary-Nonficti...
is wonderful. I have my doubts about whether the professor who posted that long excerpt on a public website really understands what "fair use" is about in United States copyright law. But if readers read the excerpt after following the link here and then buy the book, that would be a good outcome.
1. Apply the better writing advice to my everyday speech
2. Focus on writing down exactly what I wanted to say, and how I would have said it
School taught me to be super wordy and focus overly on the editing stage. Nowadays, I read everything I write out loud and if it sounds awkward (or not like me) then I just delete it and write it again from scratch. Oftentimes it helps to just close my eyes, say what I want to out loud, then write down what I just said.
It can turn out to be a little bit wordier, but it almost always ends up being easier to read :)
[0] https://www.orwellfoundation.com/the-orwell-foundation/orwel... [1] https://news.ycombinator.com/item?id=31060362 [2] https://www.amazon.com/Writing-Well-Classic-Guide-Nonfiction...