DevOps

'Don't Google Google, Googling Google is wrong', says Google

Chocolate Factory unwraps developer style guide, squibs the thorny ISO date debate

By Richard Chirgwin

210 SHARE

If you want to write developer documentation like a Google hotshot, you'd better kill “kill”, junk “jank” and unlearn “learnings”.

Those are just a few rules from the company's newly open-sourced (oops, two sins there, verbing and hyphenation) developer documentation guide.

Even though any Linux user knows “kill” is a command, Google would rather you not use it as a verb – “stop,” “exit,” “cancel,” or “end” are preferred. “Jank” (Wiktionary says “blocking of a software application's user interface due to slow operations or poor interface design”) should be used with care; and thankfully, “learnings” get a simple “don't use”.

And yes, what we said in the headline is correct. Google's style gurus have ridden out in a crusade against verbing the corporate noun: “Don't use as a verb or gerund. Instead, use 'search with Google'” (we consider it admirable that Mountain View expects “gerund” to get by without a developer Googling it – sorry, “searching it with Google”).

The guide carries plenty of evidence of a long debate about what words can be both noun and verb: “login” is a noun, with “sign in” given as the preferred verb; “backoff (noun), back off (verb), back-off (adjective)” are noted; "clickthrough/click through" are similarly stipulated; and “display” is troublesome because it's intransitive (Google it. Damn, we broke the rule again, we meant “search 'intransitive' with Google”).

“Interface” gets similar treatment: if you're reaching for a verb, the preferred list is: interact, talk, speak, or communicate.

As anyone who's tried to draft a style guide will tell you, contradictions are inevitable. So it is that “the Internet” has turned into “the internet” because other style guides (thank you very much, The Guardian) do so. However, just a couple of lines down, we find that the “internet of things” is rendered “Internet of Things” to explain why IoT is an acceptable abbreviation.

And that's just a sampling the word list. Punctuation, grammar and syntax would make pedants everywhere proud, we guess.

The Oxford Comma, controversial almost anywhere, is given Google's blessing (although not named):

Not recommended: I dedicate this book to my parents, Ayn Rand and God.

Recommended: I dedicate this book to my parents, Ayn Rand, and God

… and we learn that Google follows the usage of all civilised persons: it instructs devs not to capitalise the first word after the colon.

As an American company, Google can't risk a howl of outrage by enforcing ISO date formats over the locally-preferred Month:Day:Year. Instead, it asks me to state that this article was written on September 13, 2017.

We're sure that our readers will find many more amusements, outrages, and debates in the guide. Let us know what you find in the comments. ®

Sign up to our NewsletterGet IT in your inbox daily

210 Comments

More from The Register

OK, Google. Music in 2019 isn't what it was, but Play nice, will ya?

Bug appears to hate tunes released this year

Google Play Store spews malware onto 9 million 'Droids

How did these get through the net?

FYI: Drone maker DJI's 'Get it on Google Play' website button definitely does not get the app from Google Play...

Updated Quadcopter slinger rudely palms folk off to .apk download

Latest Google+ flaw leads Chocolate Factory to shut down site early

52.5 million accounts at risk, tens of people are worried

Here you go, cloudy admins: Google emits NATty odds 'n' sods

Google Cloud Next Incremental titbits aimed at time-poor techies

Google's secret to a healthy phone? Remote-controlling your apps

Look Ma, no not much malware!

Thanksgiving brings together Apple's Siri and Google Assistant

A divided tech nation embraces, uncomfortably

Roses are red, we've received about fifty. Google's next trick? Pixels for the thrifty

Cheap Google mobes this year, at least according to Nikkei

Google hands out roses to preferred Android MDM vendors

Lucky few get Chocolate Factory's endorsement as Enterprise Mobility Management

Google-whisperers beat reCaptcha voice challenge with 90% success rate

Code's up on Github and Google's fine with that