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...
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.
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.
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...
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...
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...
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...
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:
Editing codes are heaps cool and here I indulge some flights of fancy about their future.
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. 😤
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...
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?
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.
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!”....
Editing in open source is about nurturing writers and non-writers, and watching where you tread to sustain a path of non-code contributions.
Being an async tech editor lets me wring the most value out of my time.
What does it mean to understand complex technical topics at a high level?
Like any activity, technical editing has its own set of languages and tools.
I write about technical editing. Here’s what I mean when I use the term “technical editing”.
Reading List Each of these sites has a collection of resources covering style guides, books, courses and professional organizations.
