The language we use when we write helps connect with our target audience. Connection is important to show empathy and establish trust with the reader.

writing editing podcast

This year I joined Foster as a contributor. Foster is a writers collective who are assembled around a GDocs Chrome extension that allows authors access to real-life editors and collaborators. Writers get timely feedback from experts. Contributors (like me) get...

editing tech-writing foster

Symfony’s contribution guidelines contains a section called Respectful Review Comments - it gives specific details for using language when commenting on pull requests and issues.

asynchronous opensource symfony editing

Blogstars is a series where I review articles written by tech bloggers and call out things they’ve done well, to help other bloggers improve their writing.

editing tech-writing

This is in response to The Editing podcast episode: 4 types of editing for 4 kinds of writer. I highly recommend listening to this podcast! Check out my other responses: Editing the confident writer Editing the nervous writer Editing the...

opensource styleguide writing feedback editing

This is in response to The Editing podcast episode: 4 types of editing for 4 kinds of writer. I highly recommend listening to this podcast! Check out my other responses: Editing the impatient writer Editing the confident writer Editing the...

writing feedback editing

This is in response to The Editing podcast episode: 4 types of editing for 4 kinds of writer. I highly recommend listening to this podcast! Check out my other responses: Editing the impatient writer Editing the nervous writer Editing the...

opensource styleguide writing feedback editing

This is in response to The Editing podcast episode: 4 types of editing for 4 kinds of writer. I highly recommend listening to this podcast! Check out my other responses: Editing the impatient writer Editing the nervous writer Editing the...

writing feedback editing

In From code reviews to prose reviews, I describe a 4-step process for doing a review. Three of those steps involve writing! Here I want to dig deeper into each of those bits of writing:

blogging review editing

Editing codes are heaps cool and here I indulge some flights of fancy about their future.

writing feedback editing editing-codes

You need to pack a lot of punch into your editing comments. They need to explain the what, why and what-next, all at once. It can be hard to fit all that in. 😤

writing feedback editing editing-codes

You’re coding all day and now you have to review a how-to article that your colleague has written for the dev portal. Or maybe the tech team lead wants you to review a post for the company blog. If writing...

devrel review editing

Turns out I’m pretty good at editing. Who knew?! Certainly not me. I thought everyone had it. Every tech writer is probably a good editor, aren’t they?

skills editing writing

Editing comments should be constructive, kind, and actionable. If you’re asked to review a piece of text, here are my tips for creating a useful comment. Try to cover the what, the what’s-up, the why **and the **what now.

writing feedback editing

There are many different names used to describe the different types of editing. The waters are murky—and the hosts of The Editing Podcast agree. In The different levels of editing episode, Louise exclaims, “The language of editing is so tangled!”....

writing editing

Editing in open source is about nurturing writers and non-writers, and watching where you tread to sustain a path of non-code contributions.

editing open-source i18n

Being an async tech editor lets me wring the most value out of my time.

editing

What does it mean to understand complex technical topics at a high level?

editing

Like any activity, technical editing has its own set of languages and tools.

editing tools

I write about technical editing. Here’s what I mean when I use the term “technical editing”.

technology editing

Reading List Each of these sites has a collection of resources covering style guides, books, courses and professional organizations.

editing tools