Here, a line length exceeding 104 columns causes line wrap.
Should the style guide recommend 80 column width for comments?
There should be a process to collect suggestions, polish them through
discussion on chat platforms, forums, emailing lists and then throw
them out or keep them in a style guide.
I’ve created a
##FoundationDB channel on
freenode for chat and can
hand ownership to somebody official here. It has been linked to the
In the code block that follows, lines 430 and 441 are comment
duplicates the style guide could reject for reasons collected and then
point to a wiki for better ways than doing that.
Ideally, comments would read as smoothly as follows in 80 columns or less :-
// It is almost always clear from context what people mean.
// When dealing with computer programs, however, it is important
// to keep the distinction in mind, since the computer is not as
// smart as a person.
Would a tech journo be able to phrase what is going on there without cartwheeling the terms in the one sentence, one sentence?
The C++ section of the style guide has pointers to :-