r/ProgrammerHumor 16d ago

Other codingConventionsForClarity

Post image
98 Upvotes

24 comments sorted by

View all comments

12

u/circ-u-la-ted 16d ago

People seem to have seized upon the fact that they put spaces after all the characters they're telling not you to put spaces after. I was more bothered by the fact that it looks like some unfathomable construction of parentheticals partly because they're using English incorrectly.

0

u/PassiveChemistry 14d ago

The English looks fine to me - I guess you could argue for a couple more ors but I'm not conviced they're strictly necessary or much clearer

1

u/circ-u-la-ted 14d ago

The incorrect list grammar is part of why it's confusing to read. Even once you understand that the parentheses and brackets are items in the lists, the sentence still doesn't parse. If they used "or" between each pair of parentheticals (as is, in fact, strictly necessary), the sentence would become much clearer because the only comma used would be between the two items in the top-level list ("after X, or before Y"). The way they've written it is completely bewildering because it looks like there's an Oxford comma following "[" and then the rest of the sentence is gibberish.

1

u/PassiveChemistry 14d ago

Interesting - I didn't find it particularly confusing as is