Live data from Hacker News

Ask HN: Is it possible to live off technical writing?

news.ycombinator.com

41–50 of 67 posts

Re: Ask HN: Is it possible to live off technical writing?

#41

I can't speak to the people writing books on coding, etc., but I have written a lot of product documentation and am thinking about doing it full time as an independent consultant. The small startups where I have worked have had woefully bad documentation. Developers and support reps never have time or want to write it. I would say the most useful thing I have done for these companies has been to set them up with a ba…

Sounds pretty reasonable to me.

Doing this properly is often not the most fun thing that people can be doing, but is extremely important for getting others using your, well, whatever. I remember working with an older colleague who was excellent at building up good documentation and we'd follow whatever instructions were there, hit problems and solve them, add something to the docs then go back to the beginning and go through everything again. In doing so, we could often create scripts to automate sections and improve the setup process itself.

It's a task that can be hard to get devs to spend their time on, requires skill in a few different areas and has some clear benefits (reduce dev setup time / onboarding costs, improve customer support, etc). There's no lock-in and progress and completion can be pretty clear.

There might be a good source of bounties for the same kind of thing for open source projects too.

Re: Ask HN: Is it possible to live off technical writing?

#42

It is hard to find work, I've applied to technical writing jobs only to not hear back from them. Jobs that usually pay $100 per article you write for them on a blog. I've tried self-publishing books, but they don't sell. I can't afford to market them. If you build up a lot of social network followers you can promote your books and blog links to them. I had websites but they are down now because I couldn't afford to k…

start with evergreen niches

Re: Ask HN: Is it possible to live off technical writing?

#43
post #25

I'm a technical writer at Fastly and a published author with No Starch Press. I've worked full time as a technical writer since 2006. It's a great career and I highly recommend it. If you have a technical background and you've coauthored a book, you already have what it takes to find full time work as a technical writer. There are really two ways into this field. You start with a background in English or professional…

Thanks for your insight and encouragement. I actually studied compsci and creative writing, so I have a background in both. I am still working as a software developer / "data engineer" by day, and I am starting to sketch out a small book by night.

Re: Ask HN: Is it possible to live off technical writing?

#45
I spent about a year writing technical documentation for clients as an add on service to consulting. It was a really nice experience. It was the main source of income for some months. People would try and hire me for writing but I wanted to focus on code. One trick I learned is to find not well documented projects or APIS and write tutorials about them. Then turn those tutorials into cookbooks. That sold well directly to companies. I would sell them the cookbook for their own project. It was easy and fun money.

Re: Ask HN: Is it possible to live off technical writing?

#46
post #25

I'm a technical writer at Fastly and a published author with No Starch Press. I've worked full time as a technical writer since 2006. It's a great career and I highly recommend it. If you have a technical background and you've coauthored a book, you already have what it takes to find full time work as a technical writer. There are really two ways into this field. You start with a background in English or professional…

>You start with a background in English or professional writing and learn the technology, or you can start with a computer science degree or something similar and learn how to write.

Could you please recommend some good resources for learning to write, in the context of technical writing or more generally?

Re: Ask HN: Is it possible to live off technical writing?

#47

I wrote some chapters. Great fun, but not worth it in terms of money. David Flanagan (java in a nutshell etc) couldn't do it any more, so it seems hard. He blogged about it somewhere... As always, if you make your expenses low enough, maybe...

Ironically his blog(http://www.davidflanagan.com) says right now: "My site was hacked and was hosting malware. So its down until I can rebuild it."

Re: Ask HN: Is it possible to live off technical writing?

#48
I just self-published my first book (http://survivejs.com/). Writing books is way harder than people think. Writing isn't enough as you need to tackle other aspects, such as marketing and sales, as well. If you are not native, you have the extra challenge of learning to write.

In short, it's definitely possible to earn a living out of technical writing. Getting started is the hardest part. If you don't have a reputation, you will need to build one. Growing audience will take time, but it will pay dividends.

To keep this comment short, I'll just link to a series of articles (and presentation slides) I've written about my experiences. Hopefully these help! Here we go:

* http://agile.fi/survivejs-writing-a-book-in-a-lean-way/

* http://survivejs.com/blog/succeed-at-technical-books/

* http://survivejs.com/blog/survivejs-interview/

* https://survivejs.github.io/how-to-write-a-book-and-survivej... (Chrome works the best)

Best of luck!

Re: Ask HN: Is it possible to live off technical writing?

#50
post #45

I spent about a year writing technical documentation for clients as an add on service to consulting. It was a really nice experience. It was the main source of income for some months. People would try and hire me for writing but I wanted to focus on code. One trick I learned is to find not well documented projects or APIS and write tutorials about them. Then turn those tutorials into cookbooks. That sold well directl…

Hmmm. Very interesting. Mind if I ask a few questions?

Would you publicize the tutorials and cookbooks to the public (via a blog or project email list) before you sold the cookbooks to the companies?

How many of these did you do?

What was the level of effort for each of the cookbooks?

What did the company do with the cookbook? Put it up on their website?

Post reply on HN