top | item 33534463

(no title)

bot347851834 | 3 years ago

Thanks for the suggestion of Jekyll + GitHub Pages. I'm looking forward to testing it as I'm currently in the process of starting my personal blog.

Q: Do you have any recommendations for the writing part as well? Most of the decent guides I could find (there's so much SEO spam in the space it's incredible!) are centered around fiction or general book writing instead of blogs, and I find most of them to be rather shallow.

For example, I feel like a blog post that shows how the editing process works with explanations on why certain phrases were deleted or rewritten could do wonders to my writing because as a non-native English speaker and "technical technical writer" I tend towards over-explaining myself with long phrases.

discuss

order

vanilla_nut|3 years 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.