Isn't the official style guide a bit a messed up of different things?

Am I the only one to think that the Style Guide in the official doc is a bit a mix of two separate things?

While similar at the higher level, for “style guide” you may meaning two things that remain separate:

First, stlye guide related to visual aspects of the code: the identation/spaces/alignments, object names (the exclamation mark) and name casing, structuring of block, line length, …

All this doesn’t change the AST/IR, just make it easy to read the code by the persons that didn’t write it.

Second, there are “suggestions” that helps in the code being more efficient (and this already have another place in the doc) or maintenable/generic… and obeying to these rule would change the code behind visual elements…

You don’t think the two kind of style guides should get different pages instead of being merged together ?

2 Likes

You could say the same about the SciML style guide. (Personally I’m not bothered by the mix, though you make an interesting observation.)