Google Developer Documentation Style Guide

https://developers.google.com/style/

by rodionos • 8 years ago

36 7 8 years ago

developers.google.com

rodionos• 8 years ago

Here's the Microsoft Guide, for comparison: https://docs.microsoft.com/en-us/style-guide.

This season it's 'select ... button'.

fabatka• 8 years ago

I never considered this, but actually reserving IP addresses and telephone numbers for using in examples and fiction (as listed in the Example domains and names section) must be necessary. I'm curious how effective a prank would it be to switch an example phone number to a real one in a documentation that is read frequently.

Also, hallelujah for this: "In document titles and page headings, use sentence case. That is, capitalize only the first word."

HankB99• 8 years ago

867-5309 is a phone number that can't be used anywhere (at least where phone numbers take that format.)

panarky• 8 years ago

It's from an old Tommy Tutone song.

https://www.youtube.com/watch?v=6WTdTwcmxyo

no_carrier• 8 years ago

Then it's ironic that the title of the page is 'Google Developer Documentation Style Guide'

j10sanders• 8 years ago

I did not realize that 'crazy' is considered Ableist language:

Not recommended: There are some crazy outliers in the data.

Recommended: There are some baffling outliers in the data.

https://developers.google.com/style/inclusive-documentation#...

heyoni• 8 years ago

That’s crazy...

Hooray, low effort comments!

Google Developer Documentation Style Guide

Related Stories