C++.Coding.Standards.1918.Rules.Guidelines [Electronic resources] نسخه متنی

Preface

Get into a rut early: Do the same process the same way. Accumulate idioms.

Standardize.

The only difference(!) between Shakespeare and you was the size of his idiom listnot the size of his vocabulary.

Alan Perlis [emphasis ours]

The best thing aboutstandards is that there are so many to choose from.

Variously attributed

We want to provide this book as a basis for your team's coding standards for two principal reasons:

• A coding standard should reflect the community's best tried-and-true experience:
  It should contain proven idioms based on experience and solid understanding of the language. In particular, a coding standard should be based firmly on the extensive and rich software development literature, bringing together rules, guidelines, and best practices that would otherwise be left scattered throughout many sources.

• Nature abhors a vacuum:
  If you don't consciously set out reasonable rules, usually someone else will try to push their own set of pet rules instead. A coding standard made that way usually has all of the least desirable properties of a coding standard; for example, many such standards try to enforce a minimalistic C-style use of C++.

Many bad coding standards have been set by people who don't understand the language well, don't understand software development well, or try to legislate too much. A bad coding standard quickly loses credibility and at best even its valid guidelines are liable to be ignored by disenchanted programmers who dislike or disagree with its poorer guidelines. That's "at best"at worst, a bad standard might actually be enforced.