Found 22 comments on HN
idlewords · 2016-09-10 · Original thread
The best guide I've ever read to writing nonfiction is William Zinsser's "On Writing Well". If you do any writing for work or pleasure, his advice is indispensable:

https://www.amazon.com/Writing-Well-Classic-Guide-Nonfiction...

On Writing Well is entertaining on top of being instructive and informative. Very short read too. Every should get a copy.

http://amzn.to/2aT5qJw

nazka · 2015-11-23 · Original thread
On top of what have been said, there are two important advantages over young people that old devs should have. The first advantage is that compared to young people your advantage is your long experience in Computer Science. For instance: you should have a better understanding of your stack, you have mastered a lot of the basics of CS with several paradigms in different programming languages, databases SQL/NoSQL, etc... You may have a little bit of knowledge around the edge of your stack and outside...

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...

e12e · 2015-09-25 · Original thread
I'm afraid I don't really write enough to comment on how you should get started. Or rather how you should get finished. The idea of noting down ideas, snippets in a book (or digitally) is good. I have a couple of rats nests of small items, and todos, ideas -- 2/3s in various ColorNote[c]s on my Android -- the rest in text files in a mercurial repo).

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))

samsolomon · 2015-08-08 · Original thread
On Writing Well by William Zinsser http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...

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.

I have three short answers for you.

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.

brudgers · 2015-03-02 · Original thread
Zinnser's On Writing Well improved my writing. Alabama Power does not take internet points, however, and I remain talentless.

http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...

These two books helped me. The downside is I get annoyed now when reading other people's bad writing.

http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...

http://www.amazon.com/The-Curious-Case-Misplaced-Modifier/dp...

MarlonPro · 2013-07-31 · Original thread
@sillysaurus I'm not sure if you're a book-reader. I am reading your comment and I am seeing the exact person this book is talking about. If you like to read about non-fiction writing, I suggest "On Writing Well" by William Zinsser.

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.

e12e · 2012-11-25 · Original thread
The best single source I've come across that helps with writing, is "On Writing Well":

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.

griffordson · 2012-10-30 · Original thread
On Writing Well, by William Zinsser is a classic that you may find useful.

http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...

jeremyt · 2012-07-13 · Original thread
I've read those, which are good, but I think this one is better than all of them put together:

http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...

iamdann · 2012-06-22 · Original thread
On Writing Well by William Zinsser (http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...) is fantastic. It's not specifically about ad copy, having passion about what you're writing, as well as the fundamentals in this book, will help a ton.
bretthardin · 2011-11-22 · Original thread
I read somewhere, "It doesn't matter what you write, just write."

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...

kroger · 2010-07-06 · Original thread
I recommend On Writing Well by William Zinsser:

http://www.amazon.com/Writing-Well-30th-Anniversary-Nonficti...

jgrahamc · 2010-04-06 · Original thread
When I was working on my book O'Reilly sent me a copy of "On Writing Well" by William Zinsser (http://www.amazon.com/Writing-Well-Classic-Guide-Nonfiction/...). I read the entire book and I thought it was well worth it. One of his best pieces of advice is to end each paragraph leading the reader to the next one; the reader should want to know more.

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.

cwb · 2009-06-01 · Original thread
Strunk & White's The Elements of Style deserves a mention here in case anyone has missed it -- clear, concise, and practical writing advice.

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...

TomOfTTB · 2009-02-24 · Original thread
I agree with what the author is saying but take a slightly different approach to it. I think writing well is important but I think more focus should be put on writing succinctly. Because if you write succinctly it forces you to be clear.

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.

tokenadult · 2009-02-19 · Original thread
The excerpted book

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.

Get dozens of book recommendations delivered straight to your inbox every Thursday.