Making the Google Developers documentation style guide public

Posted by Jed Hartman, Technical Writer

You can now use our developer-documentation style
for open source documentation projects.

For some years now, our
technical writers at Google have used an internal-only editorial style guide for
most of our developer documentation. In order to better support external
contributors to our open source projects, such as Kubernetes, AMP, or Dart, and to allow for more consistency
across developer documentation, we’re now making that style guide public.

If you contribute documentation to projects like those, you now have direct
access to useful guidance about voice, tone, word choice, and other style
considerations. It can be useful for general issues, like reminders to use
second person, present tense, active voice, and the serial comma; it can also be
great for checking very specific issues, like whether to write “app” or
“application” when you want to be consistent with the Google Developers style.

The style guide is a reference document, so instead of reading through it in
linear order, you can use it to look things up as needed. For matters of
punctuation, grammar, and formatting, you can do a search-in-page to find items
like “Commas,” “Lists,” and “Link text” in the left nav. For specific terms and
phrases, you can look at the word list.

Keep an eye on the guide’s release notes page
for updates and developments, and send us your comments and suggestions via the
Send Feedback link on each page of the guide—we want to hear from you as
we continue to evolve the style guide.

Also found at : Making the Google Developers documentation style guide public

Post author

Dustin Gurley is an Designer, Developer, Artist, Instructor, Critical Theorist and Systems Engineer. He has an extensive background working professionally with 2D/2.5D/3D Motion Graphics, Compositing, Film, Video, Photography and client-side performance techniques as it pertains to web development. Dustin recently completed work on his Master of Fine Art degree in Motion Media Design (Motion Graphics) from the Savannah College of Art and Design. Prior to beginning his graduate work, Dustin obtained a Bachelor of Art degree in Communication Studies with a concentration in Broadcast and Emerging Media from the University of North Carolina at Wilmington. In addition to design and modeling, Dustin enjoys toying with his view camera, working with scratch film, authoring media related material and contributing to various industry conferences. When not in front of a computer, Dustin can be found with his wife, Regina Everett Gurley. The couple enjoys dividing their time between their home just outside of Raleigh, North Carolina and the beautiful North Carolina coast. Currently, Dustin serves as the Lead Instructor of Internet Technologies for Wake Technical Community College in Raleigh, North Carolina.