TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

Google Developer Documentation Style Guide

36 pointsby rodionosalmost 7 years ago

3 comments

fabatkaalmost 7 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&#x27;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.<p>Also, hallelujah for this: &quot;In document titles and page headings, use sentence case. That is, capitalize only the first word.&quot;
评论 #17203006 未加载
评论 #17202172 未加载
rodionosalmost 7 years ago
Here&#x27;s the Microsoft Guide, for comparison: <a href="https:&#x2F;&#x2F;docs.microsoft.com&#x2F;en-us&#x2F;style-guide" rel="nofollow">https:&#x2F;&#x2F;docs.microsoft.com&#x2F;en-us&#x2F;style-guide</a>.<p>This season it&#x27;s &#x27;select ... button&#x27;.
j10sandersalmost 7 years ago
I did not realize that &#x27;crazy&#x27; is considered Ableist language:<p>Not recommended: There are some crazy outliers in the data.<p>Recommended: There are some baffling outliers in the data.<p><a href="https:&#x2F;&#x2F;developers.google.com&#x2F;style&#x2F;inclusive-documentation#ableist-language" rel="nofollow">https:&#x2F;&#x2F;developers.google.com&#x2F;style&#x2F;inclusive-documentation#...</a>
评论 #17202746 未加载