Skip to content

Google’s style guide for software developers

By Mike Pope and Jed Hartman At Google, we produce a lot of documentation for software developers. We have hundreds of thousands of pages of documentation for Google Cloud products, Android, Google Maps, and other technologies. You can imagine the challenge of trying to make all this text consistent and to make it sound like it comes from one company. The best tool we have for this challenge is the Google developer…

Read More

Critical-thinking copyediting

By Christine Steele I have visited the book sale table at every ACES conference way more than I should. (After all, I’m a book collector, not a book hoarder!) Each year there are new and old selections on the table, and some are written by conference attendees. One would always make a repeat appearance, but I thought it didn’t apply to me: Strategic Copy Editing by John…

Read More

Mind (be careful with) your idioms

By Valerie S. Berman, EdM My fascination with idioms began at a Weight Watchers kickoff meeting 35 years ago. As I sat in a circle with a few other newcomers, we listened to each other’s weight stories. When my turn came, I explained that I’d had knee surgery and gained a few pounds during my recovery. Without hesitating, the facilitator asked, “Oh, so you saw the writing on the wall?”…

Read More

Post-rejection editing

By Laura A. Wackwitz, Ph.D. My first rejection as a writer came in the form of public humiliation. I was sixteen years old. As a member of Harbinger, my high school literary arts magazine, I’d submitted a poem for publication consideration. My teacher—our sponsor—liked it so much that she thought it a shoo-in for the…

Read More

The characteristics of effective, eye-catching headlines

By Dana Sitar An article’s headline has an important job: get someone to read the story. It places that huge responsibility on about 60 to 70 characters. You have to get creative to make sure every word, letter, space, and punctuation mark in your headline is totally necessary and carries its fair weight. What makes…

Read More

Conscious language: A to z of terms to consider

By Sofia Matias Conscious language needs to be taken into account across a wide variety of areas, from gender to age, to sexual orientation and socioeconomic status. Having a resource that can quickly scan through a document to point out any terms that editors should reconsider or delete altogether can, therefore, be a huge timesaver.…

Read More

Branding together

By Christy Zuccarini If you’ve ever been involved in the development of a brand, you’ve probably learned that “brand” is about more than a mark. Our brand is our personality; it represents what makes us stand out from others. How we talk about our work is crucial to how we are perceived by and engage an…

Read More

Is your punctuation too varied?

By Marianne Goss When I started blogging on ChicagoNow five years ago, the managing editor offered me feedback: I use too much punctuation. Editor friends laughed at the comment, thinking he meant I should punctuate less often. What he meant, however, was that I use too many different punctuation marks. His comment amused me, too,…

Read More

AP Stylebook: Write Right

By Paula Froke Spell-check can’t help you correctly select there, their or they’re. But the AP Stylebook can. Some of the most popular style tips we share on the AP Stylebook Twitter account are commonly confused words. Here’s a sampler of some of the distinctions we have shared to help ensure, not insure, you get it right:…

Read More
Scroll To Top