News for hackers. Stuff that matters.
Re:Google Developer Documentation Style Guide by fabatka on Thursday May 31, 2018 @07:35PM (#17201286)
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."

Re:Google Developer Documentation Style Guide by no_carrier on Friday June 01, 2018 @02:19AM (#17203006)
Then it's ironic that the title of the page is 'Google Developer Documentation Style Guide'
Re:Google Developer Documentation Style Guide by HankB99 on Thursday May 31, 2018 @10:36PM (#17202172)
867-5309 is a phone number that can't be used anywhere (at least where phone numbers take that format.)
Re:Google Developer Documentation Style Guide by panarky on Friday June 01, 2018 @03:22PM (#17209035)
It's from an old Tommy Tutone song.

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

Re:Google Developer Documentation Style Guide by rodionos on Thursday May 31, 2018 @07:10PM (#17201147)
Here's the Microsoft Guide, for comparison: https://docs.microsoft.com/en-us/style-guide.

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

Re:Google Developer Documentation Style Guide by j10sanders on Thursday May 31, 2018 @08:05PM (#17201405)
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#...

Re:Google Developer Documentation Style Guide by heyoni on Friday June 01, 2018 @01:06AM (#17202746)
That’s crazy...

Hooray, low effort comments!