DEV Community

Ryan Haber
Ryan Haber

Posted on

4 2

Resources to Improve Your Writing

treasure!

I am frequently asked, “What are some good places to learn technical writing?” This page will be an evolving document listing off forums, organizations, and even books (gasp!) that have helped me improve my game. I may include some that look excellent even if they haven’t been pivotal in my particular career.

Solid, Automated Feedback on Your Writing

  • The Hemingway App is geared toward improving your writing. Generally, it seems to score with an eye toward helping you write very clean, active prose more or less suitable for tech writing. It gives lots of generally good advice about writing good, clean prose.

  • Readable.io evaluates text giving you a variety of scores based on different academic scales that I don’t understand. But what I do understand is the simple letter grade that it gives. It also gives you some statistical feedback, such as the percentage of your words that are adverbs.

Books and Online Guides

English and Tech Comms Usage

  • To The Point: A Dictionary of Concise Writing. If you can reduce every phrase from 3 to 2 words, you save your readers 1/3 of your life and they will love you for it. Look up a phrase and this nifty book provides a briefer alternative. I use it when I sense my inner poet driving my tech comms work. The more you use it, the less you need to.

  • Microsoft Manual of Style for all language more specific to software documentation as well as formatting usage.

  • Chicago Manual of Style online, or buy a copy to settle all questions about grammar and usage.

  • The Elements of Style, because it’s inexpensive, brief, and an excellent guide to how to write clean and simple prose. If you haven’t read it, you probably stink at writing. Just kidding. Kind of.

  • The Complete Plain Words, basically a longer form of The Elements of Style and - I’m not joking - good for daily reading. It teaches more about a mentality than about memorizing rules and helps you learn to empathize with your poor reader.

The Craft of Tech Comms

Organizations

  • Society for Technical Communications is a real-life organization to help tech comms people network and improve our craft. The society produces salary guides, a peer-reviewed journal as well as an online magazine, and lots of activities and an annual conference. Disclaimer: I’m a member. Warning: it’s not cheap. Advice: I do find it worthwhile or I wouldn’t keep renewing.

  • Write the Docs From their website: “Write the Docs is a series of conferences and local meetups focused on all things related to software documentation… We consider everyone who cares about communication, documentation, and their users to be a member of our community. This can be programmers, tech writers, developer advocates, customer support, marketers, and anyone else who wants people to have great experiences with software.”

Forums Online

Image of Timescale

🚀 pgai Vectorizer: SQLAlchemy and LiteLLM Make Vector Search Simple

We built pgai Vectorizer to simplify embedding management for AI applications—without needing a separate database or complex infrastructure. Since launch, developers have created over 3,000 vectorizers on Timescale Cloud, with many more self-hosted.

Read full post →

Top comments (0)

Billboard image

The Next Generation Developer Platform

Coherence is the first Platform-as-a-Service you can control. Unlike "black-box" platforms that are opinionated about the infra you can deploy, Coherence is powered by CNC, the open-source IaC framework, which offers limitless customization.

Learn more

👋 Kindness is contagious

Discover a treasure trove of wisdom within this insightful piece, highly respected in the nurturing DEV Community enviroment. Developers, whether novice or expert, are encouraged to participate and add to our shared knowledge basin.

A simple "thank you" can illuminate someone's day. Express your appreciation in the comments section!

On DEV, sharing ideas smoothens our journey and strengthens our community ties. Learn something useful? Offering a quick thanks to the author is deeply appreciated.

Okay