Download My In-House Style Guide Template to Use However You Want

I’m excited to share the template I use for creating in-house style guides, as a reward for The Responsible Communication Style Guide Kickstarter reaching $10,000 in backing. Want to really improve your company’s communications? Back the Kickstarter today!

TL;DR: Here’s the link to download my in-house style guide template: the style guide as a .docx!

Keep reading for some context!

Whenever I sit down with a prospective client to work on their content, I ask about style guides: Does the organization or project rely on a particular style guide? How do they enforce style guidelines? How do they update the style guide?

I get a lot of blank stares. That’s okay, because very few of the organizations I work with are founded by trained content creators. While I know that anyone who already has a style guide in place will be easier to work with, I don’t consider a lack of a style guide a problem — at least before we start working together. I do insist, however, on making a style guide before we start on any other content projects. I need a style guide before I can create new content, audit old content, or even decide on what belongs in an editorial calendar.

Creating an in-house style guide isn’t that difficult of a process, provided you’ve made a couple dozen style guides over the length of your career. Part of that is experience. Part of that is building a template that can be customized to different organizations quickly. While I can’t give you a self-serve package of my expertise, I can give you the template that I’ve built up over the past decade or so.

I’m sharing this document as a .docx so you can easily adapt it to your own ends. You’ll want to start by reading through the style guide and adding in the information your organization needs to reference regularly (like exactly how to spell, space, and capitalize your company name). After that, you can share it with your team.

Remember, your style guide is a living document. Whenever new questions come up, add the answers to the guide. Whenever your organization hires a new person or releases a new product, add them to the guide. Whenever a content creator screws something up, add the information they need to avoid future problems to the guide. Schedule a regular review to update and clarify your in-house style guide. This template, by the way, is also a living document. I keep adding information to it, tweaking it, and looking for ways to improve it.

You’ll notice that there’s some information about writing inclusively in this guide. If this is a topic you’re just starting with, I recommend reading the white paper I released with Recompiler Media on quick changes your marketing team can make to dramatically increase your audience (PDF!) with an inclusive approach. If you aren’t thinking about inclusivity, you’re probably reaching only a fifth of your potential audience. If you are thinking about inclusivity, you can take your content to the next level by backing The Responsible Communication Style Guide Kickstarter.

Good Things from Other People — September 12

Portland’s Community Podcast Studio

There’s an Airstream trailer here in Portland that’s been retrofitted as a podcast studio. Stream PDX has only just launched, but it has the potential to help a lot of folks record audio who wouldn’t have been able to otherwise.

Rachel Nabors’ Intro to the Web Animations API

If you still don’t believe that documentation can be mind-blowing, check out “Using the Web Animations API” on MDN. Rachel Nabors created incredibly gorgeous animations as a part of this introduction (with the full code available to look at). Rachel’s animations are drawn from Alice in Wonderland and I want to see the rest of what Rachel would do with that story!

Mideast Tunes

How do you push for social change in countries with tight censorship? Mideast Tunes is using music to spread messages of social change, as well as to give artists a platform. The organization running Mideast Tunes is, which also runs a variety of other projects (check all of them out!). Meri Williams has offered to match donations to Majal up to $10,000.

The Responsible Communication Style Guide: A Kickstarter and an Explanation


I’m working on The Responsible Communication Style Guide with Recompiler Media. This project is something I’ve been thinking about for years and I wanted to write up how I got to this place.

Our Kickstarter is here — backing at the $15 level is the fastest way to get a copy of The Responsible Communication Style Guide to use in your own work.


This post is over 2,500 words. There’s some heavy emotional stuff in here (lived experience + the Holocaust, how language affects our lives, and diversity in technology). I do hope you’ll read the whole thing.

How to Screw Up as a Journalist in One Easy Step

I screwed up early in my career as a freelance writer: I conducted an email interview with an individual named “Chris” for an article I was working on. In the article, I referred to Chris with a male pronoun. My source emailed me immediately after reading the article to say that “Chris” was short for “Christine” and that she would appreciate me fixing the error.

Chris was super nice about the whole thing, making me think that I wasn’t the first person to make this particular mistake. Now I do some obsessive Google-ing if I’m not sure how to describe a person just from an interview — though even Google can’t always tell me enough information.

Ever since, I’ve also been looking for a guide or workshop or some sort of education on how to ask questions about identity without being offensive. Sure, asking someone their pronouns is one of my standard interview questions (along with how to spell their name and what their professional title is), but that’s not enough.

  • How do you even begin to ask a trans person about referring to them by their dead name if you’re writing about them during a time when they still used that name?
  • How do you make sure that unconscious bias doesn’t influence your writing?
  • How do you write about someone engaged in activism without bringing an internet shitstorm down on their heads?
  • Heck, how do you even determine if you’re only telling stories about people like you or if you’re finding diverse sources or stories?

I don’t have the one true answer to all these questions. Figuring out how to handle these sorts of topics requires both empathy and context. Context, in turn, requires lived experience.

What is ‘lived experience?’ Lived experience, or the experiences, emotions, and impressions of a person living as a member of a minority, is easily dismissed as a buzzword from a women’s studies class. Hanging out in tech circles, I mostly hear people talking about their lived experiences and how they differ from what other people may see (such as a woman talking about an act of discrimination, only to be told by a man that he’s never seen any problems in the industry). While I don’t think that this sort of gaslighting should be dismissed, there are even bigger dangers to ignoring others’ lived experience: My paternal grandfather was a Holocaust survivor. He spent six years in concentration camps. When he was liberated in 1945, he was 18. He weighed 85 pounds. In the years that followed, my grandfather encountered Holocaust deniers. These people told my grandfather that the hell he went through never happened.

I don’t want to turn this blog post into an example of Godwin’s Law, but every time I hear someone discounting lived experience, I see them become a little more willing to accept anti-Semitism and other bigotry. Suffice it to say that I strongly believe in the importance of involving someone with lived experience when creating training materials about their identity, history, community, and other related topics.

Back to the Question at Hand: Improving Our Ability to Communicate

At the same time, expecting anyone (no matter their lived experience, expertise, or knowledge) to educate either individuals or organizations purely out of the goodness of their heart is both rude and unreasonable. My landlord doesn’t let me live in my apartment out of the goodness of its warm, fuzzy, corporate heart, so I need to spend my time in a way that gets my rent paid — and I expect the same to be true of every human I encounter. (Kronda Adair has written several brilliant posts on this topic — start with this post.) In the event we all wind up living in a communist utopia, remind me to revisit this point.

That means paying multiple editors to look over my work who can bring the right context to it, right? Since I don’t have a lot of money, I generally can’t afford to work with more than one editor on a project. As it happens, since I write for the web, I often can’t afford to work with even one editor.

When I’m flying without a grammatical net, there are some options for improving my writing without spending a ton of money:

  • I use a ton of technology. There are tools to analyze common grammatical mistakes, such as the spell check tool built into most word processors. But there are also tools that do more specific editing tasks, such as the Hemingway app, which helps writers to follow Hemingway’s writing advice (limited adjectives and adverbs, short sentence structures and so on).
  • I got an education in writing and communications, and then kept learning. I have a couple of degrees in communication, which included loads of classes on writing. I also still read a ridiculous amount about writing. I kept learning after getting a degree, using self-education materials available from experts, ranging from writing hacks to full-fledged textbooks. A degree isn’t necessary in this field and an in-person class isn’t even required.
  • Lastly, I adore my style guide. I don’t (usually) sleep with the AP Stylebook, but I still keep both the digital and print copies handy. I also own a bunch of other style guides. I ask the publications I write for if they have their own style guides. I also have made my own style guides, both for individual publications I work on and more generally (i.e., I’ll go to bat with an editor to make sure ‘internet’ is not capitalized).

The resources for writing responsibly and ethically are few and far between. During my education, the closest I got to a class on how to write with some level of sensitivity was a graduate-level course on how to write about controversial topics — where ‘controversial’ was read as ‘political’ or ‘religious’ more than anything else. (Side note: That class was taught by Arthur Magida, author of How to Be a Perfect Stranger, which I have referred to as The Book that Keeps Me From Screwing Up Other People’s Weddings. I highly recommended it.)

That particular class was incredibly valuable, but I had to wait until I was working on a master’s degree to have an instructor start talking about how to start thinking about dealing with difficult topics, despite taking my first journalism class in middle school. How is there not a basic class in every journalism, public relations, and marketing program on how to write for diverse audiences? We teach basic interviewing techniques, like how to ask a question to high school journalism classes, but fail to teach those same students which questions to ask or who to ask questions of. I don’t know what your student paper looked like, but mine didn’t exactly reflect the demographics of our student body. It reflected the perspectives of the teachers leading the class and of the kids in accelerated English classes — despite having a big ESL program at our school, I can’t remember a single ESL student writing for the student paper. I’m not advocating for fully restructuring journalism (yet!) but we do need to make a point of teaching empathy in journalism.

We’re at the beginning of conversations about representation in the media. There are a few organizations now that try to track statistics on authors and writers, like the VIDA Count. Getting more diverse writers (and other media makers) into big publications is just a first step. Telling stories of underrepresented demographics is the next step — and I’m not talking about tokenism. Pro tip: it’s perfectly fine to have an article about a technical project led by a woman without ever asking her about whether she thinks tech is a tough industry for women. As a matter of fact, skipping the focus on how different the story’s subject is means that you get to spend more time on how cool the actual project is.

Some individuals and organizations have started working on this problem, but many resources are fragmented. I have more than a dozen style guides and media guides just for covering religion. (I’ll get more into what’s out there in another post I’m already working on.)

We still have a long way to go to get to a truly diverse media scene, though. I keep thinking of our current media landscape as the beginning of a very long journey — we’re still outfitting ourselves for the trek and don’t really know what’s on the trail ahead. We won’t even know some of the work we need to do to get to that far off Wonderland until we get on the road. We know that we need to remodel or replace many of the systems in place to produce journalism and other media, but until that work is done, we won’t know many of the steps that come after.

Let’s Talk Ideals and Infrastructure for Writers

In my ideal world, I could just use pronouns that aren’t based on gender for writing and everything else. I recognize that I have to stick to the current system if I want readers to be able to understand everything I publish, but I certainly don’t like the existing system.

Until there’s a good opportunity for a linguistic revolution, I’m focused on making the existing system better. That means starting with the writers who make the articles, blog posts, and other things we read (along with the scripts for plenty of the audio and video content we see, too). Style guides are a good starting point for talking about how we cover things because we’re already used to looking up details we might get wrong.

In fact, some organizations have put out specialized style guides for how writers can cover their specific communities. These resources are all over the place, however, and sometimes contradictory. Creating a standard resource is the first step to making improvements in who writes what stories. Having discussions about diversity and inclusion before publishing anything will, at least, limit some of the more thoughtless headlines and references that we see constantly. As a personal goal, I’d like to see publishers avoid referring to an Olympic athlete as someone else’s wife.

I have thought of other formats this style guide could take. I kept coming back to the idea of doing the research and running an in-person workshop, geared towards newsrooms. But while we clearly need more educational materials about writing responsibly, style guides have more power than classes. I’ve taken more writing classes than I can count. I don’t remember where all the handouts and notes are from those classes, though I can point to the occasional writing hack and say that I picked it up from a particular instructor. You could have swapped out most of my writing teachers for other writing teachers and I would never have noticed.

But taking my AP Stylebook from me would turn me into a mess. And while I could manage if you took my Chicago Manual of Style or one of the other style guides I rely on, I would be pretty unhappy. These reference books have impacted my writing far more than anything or anyone else.

Making a Real Difference with The Responsible Communication Style Guide

I’ve spent the past couple of years casually talking about making a style guide that answers some of the questions I have. Audrey Eschright, the publisher of the Recompiler, heard me talking about the idea for The Responsible Communication Style Guide this spring. She said that she wanted something similar and would be willing to work on the project.

Working with Audrey is amazing — we’re on the same page about everything except whether there’s a hyphen in ‘ebook’ (I’m anti-hyphen, while Audrey is pro-hyphen, if you’re wondering). Perhaps the most important thing we agree on is how to construct The Responsible Communication Style Guide. Our particular manifesto for this project can be broken down into the following bullet points:

  • We’re hiring the right people to write each of these sections and we’re paying them. None of that crap about asking people to educate us for free here.
  • We’re creating a printed resource, as well as a website. Different people use different formats (and we’ve got some cool ideas for even more approaches once we’ve got the initial iteration ready).
  • We’re developing training around The Responsible Communication Style Guide, because people only use resources they have some familiarity with.
  • We agree that this sort of style guide isn’t just about writing clearly. It’s also about being able to communicate in a manner that doesn’t harm anyone: writers, editors, and publishers influence culture and attitudes so directly that we have an obligation to use that power responsibly.

Yes, we’re both absolutely scratching our own itch with The Responsible Communication Style Guide. But we’re also creating something that we know there’s a need for — and something with the potential to guide major conversations in technology. Yes, journalists working in this space need the guide. But there’s more room than that in the long run. Ultimately, everyone in technology is a writer: a programmer writes documentation, technical blog posts, and internal talks, even if they never publish a single word outside of an employer’s media. Designers, marketers, and even business analysts create reams of written material every day.

This guide gives people who don’t necessarily think of themselves as writers a starting point for thinking, talking, and, yes, writing, about users in an empathetic way. There’s a real potential for The Responsible Communication Style Guide to equip us for important conversations by providing an introduction to concepts of identity and a framework for writing about those concepts.

So here we are. There’s a big chunk of my heart and soul up on Kickstarter right now. I’m a bit terrified, especially of getting things wrong with the people who I want to contribute to The Responsible Communication Style Guide. I’m ridiculously hopeful about what bringing this project to life means for the books and blogs I’ll read in the future. I’m wound up waiting to see who will back this project. We’ve got just under a month to make this happen. Let’s go.

We Need Your Help

If you are as excited as I am, we are looking for help!

  • Please consider backing our project, even at a low level. If everyone just bought an ebook copy at the $15 level, we would need just over 1,300 backers — and there are far more than 1,300 people writing about these topics.
  • Please share our Kickstarter with everyone who you think might be interested. From our perspective, that means journalists, marketers, speakers, and other folks who write publicly. But once the Responsible Communication Style Guide is a reality, we expect people to use it in ways we never considered.
  • Please let us know if you think of any ways to make this material more accessible to your community. We have some ideas (I want a linter for writing!), some of which will be incorporated into this first iteration of the guide and some of which we’ll work on after the Kickstarter (including my hopes for a linter).

Thank you for reading this whole long post and thank you for your help.

Good Things From Other People — June 9

The Healthcare Essay You Need to Read

Sarah Kliff’s essay for Vox on how patients’ free labor is crucial to our healthcare system echoes conversations I’ve had — but Sarah made the whole discussion a lot clearer.

Support AlterConf

In order to maintain the current pace of AlterConfs, Ashe Dryden needs to raise $100,000. I attended AlterConf Portland last year and it was one of the best conferences I’ve been to in my life. I encourage you to watch all of the videos from past AlterConfs, as well as financially support the events.

Make Your First Twitter Bot

Cheap Bots, Done Quick will help you create a new Twitter bot with no coding knowledge. Try it out!

Food by the Numbers

How would you culinarily display the number of people living near a nuclear power plant? What about the number of Facebook users in Arab Spring countries? That’s exactly the question driving Data Cuisine. The creators of the site also offer data cuisine workshops, where they team up with a local chef to create dishes that will represent local data.

PyCon, by the Zines

I spent last week at PyCon NA (in Portland this year — how convenient!). I made a zine to hand out explaining the Python community in Portland, along with suggesting some events for out-of-towners.

Here’s a PDF you can download if you want to check it out.

Even better, I wasn’t the only zine maker at PyCon!

Jessica Garson organized a zine open space where I met a few other media makers. Jessica also gave a lightning talk about teaching with zines (her slides are here).

Roxanne Johnson presented during the poster session (Data People: Learn Python) and brought a zine she made called “Build Your Skills in Data Analysis.”

Audrey Eschright was working on The Recompiler while at PyCon and announced the next call for contributors, covering hardware.

Good Things From Other People — May 27

A Couple of Cool Circuits

Star Simpson’s crowdfunding campaign for Circuit Classics is already funded, but you should considr backing it if you’re interested in learning more about electronics. The Circuit Classics kits each teach a different electronics concept.

The Internet Doesn’t Run on Black Magic

Want to know what’s really going on when you start clicking around on a website? Lyzi Diamond wrote up an amazingly clear explanation of how the internet works. I’m keeping this in my reference file for later.

Callisto Needs Donations

The organization behind Callisto, Sexual Health Innovations, is holding a donation drive until the end of May. An unspecified donor has offered to triple donations received by the organization in May 2016. Selena Decklemann wrote a moving post on how Callisto would have helped her.

Read This Book

I’m maybe halfway through Delia Sherman’s Young Woman in a Garden and I can already tell that I’m going to re-read this short story collection time and again. Some of the stories are clearly fantasy, while others are more magical realism, but across the board, Delia has a delicate touch that makes her writing very enjoyable.

Good Things From Other People — May 19

A Sublime Sublime Theme

If you use Sublime Text, check out this elegant theme: Fairyfloss. The theme comes from Amy Wibowo, the publisher of BubbleSort Zines. Her approach to technology makes me feel like a kid in a candy factory!

Gendered Names in AI

Rose Eveleth wrote a look at the name of the new AI legal assistant from IBM you should definitely read. Using some hard numbers around the impact of gendered names, Rose drives home the impact of not only names but of the people who choose them.

Getting Started with Storium

Storium is a storytelling game that’s resulted in some particularly interesting tales. The game now has several beginner-friendly games pulled out to get new players started.

A Thing I’m Working On

As part of my work as co-chair of Open Source Bridge this year, I’ve promised to wear whatever one lucky backer selects (within certain limits). Even if you’re not interested in my services as a walking advertisement, check out the campaign and consider backing it.

Good Things From Other People — May 12

The Edie Windsor Coding Scholarship Fund

Lesbians Who Tech is raising money to provide scholarships for LGBTQ women who want to attend a code schoolscholarships for LGBTQ women who want to attend a code school. Given how hard it is to access financial aid to attend code schools, these sorts of scholarships are crucial!

A 13-Year-Old You Should Listen To

Sebastian W gave an excellent talk at AlterConf Minneapolis about how the internet criminalizes being a child. Sebastian makes his point clearly (and tells some really funny jokes).

The Phone Wallpaper I Just Downloaded

I’ve had a stock wallpaper on my Android phone since I switched from an iPhone a couple of months ago. I figured out how to change the wallpaper, just to install this design from Post Floral.

The Piggybank Post-Mortem

Oscar Godson had the idea for Portland-based startup Piggybank 3 years ago. He walked away from it about six months ago. Here’s why.

Good Things From Other People — May 5

A Conference with a Dash of Volunteering

Affect Conf covers the “work and design behind social change” and is reinforcing that commitment by including volunteer hours as a part of the conference schedule. Both the talks and the opportunity to see inside some local Portland non-profits are well worth the cost of admission. (Full disclosure: I’m on the content committee for this conference, so I am super excited about the talks we selected.) Register for Affect Conf here.

The Right Workbook

Kari Chapin and Hannah Lee teamed up with Scout Books to create an amazing workbook for the PLA earlier this spring. I got to see some of the pages in person and they’re amazing. Scout Books has a mini-case study on the project and now I can’t stop thinking about what sort of workbooks would really benefit my own projects.

A Better Fairy Tale

The Awl sends a weekly email newsletter that changes format every time. Last week, the format was a fairy tale with an ending that sounds pretty good to me. You can see that fairy tale (plus some great illustrations) online. You can also subscribe to the newsletter on the same page, if that’s your thing.

Maybe a Good Thing?

Stripe announced a new hiring initiative where entire teams can apply to work at the company as a group. This could be really valuable for applicants — if a team’s project ends, moving as a group to a new company can be ideal. There’s an argument to be made that it might even make things easier for folks earlier in their career to access certain companies if they can apply with folks who are more advanced.

But I also have some concerns: the tech industry has a diversity problem, in part because startups tend to hire from people they already know. Keeping teams intact may make landing a job without a personal network even harder, especially for anyone who hasn’t had the privilege of working with a good team already. I’ll be keeping a close eye on this experiment.