Hacker News new | ask | show | jobs
by vanilla_nut 1313 days ago
As another "technical technical writer," I have one recommendation: find a copy editor. I built up my writing skills by jumping headfirst into a technical writing gig and writing a hell of a lot of documentation. You can learn a lot from style guides and self-editing, but the fastest way to ramp up will always be the apprentice model. If you do end up trying out GitHub Pages and Jekyll, feel free to reach out to me for a copy edit on a blog post PR! I'd be more than happy to give some tips and pass on some knowledge.

An easier goal: use a tool like Hemingway to assess the readability of your writing. Aim for Grade 6 writing level, and clean up any sections of your writing that raise complaints from Hemingway. Eventually you'll start writing at that level by default as you rewire your brain to eliminate the wordiness.