Add boolean to the style guide

[hugovk]

Fixespython/docs-community#129, which has been open for 11 months with 10 votes in favour of the Google guidance (Ned's comment + 9 👍), and no down votes, and no other suggestions.

---

📚 Documentation preview 📚: https://cpython-devguide--1636.org.readthedocs.build/documentation/style-guide/#specific-words

[StanFromIreland]

11 now:-)

[AA-Turner]

I didn't downvote the comment (that seems too harsh), but I will register support for properly capitalising Boolean as a proper noun. Three of the four style guides quoted say to capitalise, abeit one of them giving the option not to. Google's prefers using the formatting of the type (i.e. bool) where possible, and then diverges from the others in terms of spelling.

I also disagree with the notion that capitalising it is pedantic or distracting, we capitalise other proper nouns properly (e.g. Python, C API). English is a language with lots of capitalisation in places, not just at the start of sentences.

However, if this is the will of the people I won't stand in the way of progress...

A

[willingc]

I approve with adoption of @encukou / @AA-Turner's suggestion.

In general, I think using interchangeably is fine since there is no industry consensus of capitalization.

[ezio-melotti]

LGTM (once the suggested comments are applied).

[hugovk]

Yes to capitalising proper nouns, but eponyms aren't so clear cut and tend to become lowercase after enough time has passed.

Some examples:

• atlas, bloomers, bowdlerize, braille, casanova, cesarean, chauvinism, daguerreotype, derrick, diesel, gerrymander, guppy, hoover, jeremiad, jeroboam, leotard, lynch, martinet, mausoleum, narcissist, nicotine, poinsettia, quixotic, sideburns, tarmac, teddy bear, sadism, saxophone, shrapnel, volt, watt.