Add boolean to the style guide #1636
Conversation
There was a problem hiding this comment.
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
There was a problem hiding this comment.
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.
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
|
Yes to capitalising proper nouns, but eponyms aren't so clear cut and tend to become lowercase after enough time has passed. Some examples:
|
Fixes python/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