Live data from Hacker News

On Technical Writing

arturdryomov.dev

11–20 of 45 posts

Re: On Technical Writing

#11
post #8
post #7

This article is actually quite empty, it starts like it is going to be about how to write good technical content, then becomes an auto-biography, then becomes an article on how one can get started blogging, then just end abruptly with some statistics that probably nobody cares. So if you came here to know how to write, Stephen King wrote a book "On Writing" that is quite interesting and mostly reads like a novel. See…

William Zinsser’s “On Writing Well” is also quite illuminating in regards to writing non-fiction. https://www.harpercollins.com/9780060891541/on-writing-well/

Have you read Steven Pinker's Sense of Style?

https://stevenpinker.com/publications/sense-style-thinking-p...

I was thinking about reading it but it's hard to find reviews of the book that don't include praise or criticism of Pinker's other work or the author himself.

Re: On Technical Writing

#12
post #9
post #7

This article is actually quite empty, it starts like it is going to be about how to write good technical content, then becomes an auto-biography, then becomes an article on how one can get started blogging, then just end abruptly with some statistics that probably nobody cares. So if you came here to know how to write, Stephen King wrote a book "On Writing" that is quite interesting and mostly reads like a novel. See…

Better than WordPress, I would recommend substack.com Their business model is paid newsletters, but you can start with only free emails that is basically a free blog+newsletter with zero technical distractions. My shameless plug, I write irregularly about writing for developers: https://writingfordevelopers.substack.com It is not about technical writing though, but written communication.

I like the idea of Substack, but it bothers me that they only bestow a domain mapping if you have "compelling reasons and full commitment to the Substack model."[0] This should be a simple paid upgrade. What's the point of all their talk of independence if you're stuck on a Substack subdomain when the inevitable liquidity event happens?

You can export emails and migrate paying subscribers, but all your links still point to a domain someone else controls. I don't want to have to set up a redirector just to protect myself. That's the whole point of controlling the domain.

[0] https://twitter.com/SubstackInc/status/1167162063879192576

Re: On Technical Writing

#13
post #7

This article is actually quite empty, it starts like it is going to be about how to write good technical content, then becomes an auto-biography, then becomes an article on how one can get started blogging, then just end abruptly with some statistics that probably nobody cares. So if you came here to know how to write, Stephen King wrote a book "On Writing" that is quite interesting and mostly reads like a novel. See…

The article misses and fails to demonstrate the two most important parts of technical writing. Be concise and get to the point. Technical writing shouldn't be flowery and rambling. It should be focussed and say what needs to be said in as few words as possible. The article was pretty much the opposite of that.

Re: On Technical Writing

#14
post #8

Earlier quoted context omitted.

William Zinsser’s “On Writing Well” is also quite illuminating in regards to writing non-fiction. https://www.harpercollins.com/9780060891541/on-writing-well/

Have you read Steven Pinker's Sense of Style ? https://stevenpinker.com/publications/sense-style-thinking-p... I was thinking about reading it but it's hard to find reviews of the book that don't include praise or criticism of Pinker's other work or the author himself.

I've read Elements of Style but not this one. I'll check it out thanks.

Re: On Technical Writing

#15
post #8

Earlier quoted context omitted.

William Zinsser’s “On Writing Well” is also quite illuminating in regards to writing non-fiction. https://www.harpercollins.com/9780060891541/on-writing-well/

Have you read Steven Pinker's Sense of Style ? https://stevenpinker.com/publications/sense-style-thinking-p... I was thinking about reading it but it's hard to find reviews of the book that don't include praise or criticism of Pinker's other work or the author himself.

I've read it and I found it to be the most useful book on writing I've read so far, because he grounds his advice in clear linguistic principles and he is mostly not prescriptivist in his advice.

His advice about keeping an easy-to-understand sentence tree alone is worth the price of admission.

Re: On Technical Writing

#16
post #6

Earlier quoted context omitted.

"Kids these days" never really goes away huh? Funny how smart phones and social media will be our version of that.

“The children now love luxury; they have bad manners, contempt for authority; they show disrespect for elders and love chatter in place of exercise. Children are now tyrants, not the servants of their households. They no longer rise when elders enter the room. They contradict their parents, chatter before company, gobble up dainties at the table, cross their legs, and tyrannize their teachers.” ~ Socrates

In case you're wondering why you're being downvoted, the quote seems to be fake [1]. The picture that sometimes go with it, [2], is fake as well.

[1] https://quoteinvestigator.com/2010/05/01/misbehave/

[2] https://imgur.com/jwSls6X

Re: On Technical Writing

#17
post #3

« Kids certainly don’t give a damn about them either. » Well I guess it depends on how you educate them. While I’m here eating my (late) breakfast, both are in their room reading. They are 9yo (10 next spring). My son is finishing season 2 of Erin Hunter’s warriors (he loves cat) and my daughter finally catch up on Harry Potter and is reading no2 (they are not allowed to see the movies until they read the book)

Agreed, what a weird statement by the article's author. My kids love reading books. They don't read on screens much, it has to be a book.

>what a weird statement by the article's author

I can never understand this reasoning.

The statement by the article's author covers 80% or more of kids, who mostly don't read (and 90% or more reads zero to one book a year).

It's like someone noting that "people have one nose" and somebody arguing, "This is such a weird statement to make, my neighbour, who was on a traffic accident, has none"!

Extreme Outliers (1-2%), or even smaller minorities (3-10%) don't make a general statement "weird", at worse they make it not exhaustive.

(...) Conducted by psychologist and professor Jean Twenge, the study finds that the reading decline among American teens is worse than expected. In 2016, only 16 percent of high school seniors reported daily reading of a book or magazine. Roughly 40 years ago, 60 percent of high school seniors did the same.

(...) About a third of 12th graders also said they had not read a book or e-book for pleasure in the last year — which is about triple the number who said so in the 1970s.

Not much better for adults:

(...) The share of men reading for pleasure on any given day fell from 25 percent in 2004 to 15 percent in 2017, a drop of nearly 40 percent. The decline among women was a more modest 29 percent, from 31 percent in 2003 to 22 percent in 2017. The survey data shows declines in leisure reading across all age levels.

(...) Between 2003 and 2016, the amount of time that the average American devoted to reading for personal interest on a daily basis dropped from 0.36 hours to 0.29 hours. (...) From a breakdown of reading by income quartile, it turns out that the rich read more—but they read less and less every year. Americans in the lowest income quartile did manage to read more in 2016 than they did in 2003—a rare trend—but that’s probably a dead-cat bounce; the 2003 number was so low that it was as likely to improve as not.

https://www.humanitiesindicators.org/content/indicatordoc.as...

Sources: New Yorker, WP, U.S. Department of Labor, Bureau of Labor Statistics, etc.

Re: On Technical Writing

#18

« Kids certainly don’t give a damn about them either. » Well I guess it depends on how you educate them. While I’m here eating my (late) breakfast, both are in their room reading. They are 9yo (10 next spring). My son is finishing season 2 of Erin Hunter’s warriors (he loves cat) and my daughter finally catch up on Harry Potter and is reading no2 (they are not allowed to see the movies until they read the book)

"Kids these days" never really goes away huh? Funny how smart phones and social media will be our version of that.

>"Kids these days" never really goes away huh?

And it's seldom wrong either.

Kids do have different behavior in different ages. Whether that's good or bad is another thing (in some things it's bad, in others are good). But culture, habits, etc, are not the same blob of sameness for centuries. Kids in 1950 are different than kids in 2020 or kids in 1900.

In this particular case, indeed, kids these days seldom read books, whether in print or eBook form.

Whether they still read social media pages, and online news, is beside the point when it comes to reading books.

Re: On Technical Writing

#19
post #7

This article is actually quite empty, it starts like it is going to be about how to write good technical content, then becomes an auto-biography, then becomes an article on how one can get started blogging, then just end abruptly with some statistics that probably nobody cares. So if you came here to know how to write, Stephen King wrote a book "On Writing" that is quite interesting and mostly reads like a novel. See…

Malcolm Gladwell also cherry picks research findings and observations and uses them to support some narrative. He's an excellent writer. I'm just not sure how much credence I put in many of his conclusions.

I agree with your points about blogging generally though. I've sort of gotten away from doing short/casual stuff in favor of articles for pubs. This isn't entirely a bad thing as I get more reach that way but it means I've sort of dropped shorter and more eclectic writing which I should get back to.

Re: On Technical Writing

#20
post #19
post #7

This article is actually quite empty, it starts like it is going to be about how to write good technical content, then becomes an auto-biography, then becomes an article on how one can get started blogging, then just end abruptly with some statistics that probably nobody cares. So if you came here to know how to write, Stephen King wrote a book "On Writing" that is quite interesting and mostly reads like a novel. See…

Malcolm Gladwell also cherry picks research findings and observations and uses them to support some narrative. He's an excellent writer. I'm just not sure how much credence I put in many of his conclusions. I agree with your points about blogging generally though. I've sort of gotten away from doing short/casual stuff in favor of articles for pubs. This isn't entirely a bad thing as I get more reach that way but it m…

> Malcolm Gladwell also cherry picks research findings and observations and uses them to support some narrative

I'm mixed about this. I feel like this critic is true for any book. Books are not research papers.

Post reply on HN