On Technical Writing
arturdryomov.dev
On Technical Writing
1–10 of 45 posts
Re: On Technical Writing
#2« 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)
Re: On Technical Writing
#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.
Re: On Technical Writing
#4« 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.
Re: On Technical Writing
#5> There were no recommendation engines of course so I went through everything, itching to consume experiences left behind by humanity. Sounds like an addiction, right? Well, it kinda was.
Well, there kind of were. I doubt you would end up reading The Hobbit, The Three Musketeers and Sherlock Holmes purely by accident. The idea that the best content bubbling to the top of the popular consciousness is merely a product of modern ML recommendation engines is for the birds.
Re: On Technical Writing
#6« 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.
“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
Re: On Technical Writing
#7This 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 it as a "I'll read this and I'll get motivated to write".
If you came here to understand how to get into blogging: just start. Create a wordpress, and just start writing. Focus on content, not on form. After a while, you can think about a domain name, about a custom theme, or about hosting this yourself on github with hugo. But don't start with the technical parts of managing a blog, just write.
If you came here to understand how you can become a good technical writer: keep writing. Consistence over years of writing is what makes you a good writer. The ultimate technique for me is to give an interactive talk to people about your ideas, and see where your audience get stuck, where they ask questions, how different ways of explaining something get the point across.
Malcolm Gladwell does more than this: he explains an idea multiple times in different ways. If you have the page count to do this, do it. Different people need different ways of explaining.
(shameless plug: I'm writing a book on crypto https://www.manning.com/books/real-world-cryptography?a_aid=...)
Re: On Technical Writing
#8This 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/
Re: On Technical Writing
#9This 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.
Re: On Technical Writing
#10This 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/
I would second this. I always go back to this book once in a while to review how to do non-fiction writing.