ES.9 lacks example

"ES.9: Avoid ALL_CAPS names" has an "Example" section, but that should be labeled "Example, bad" to be consistent with other guidelines.

After renaming the existing example section I propose a positive example section to at least provide something like the following:

// example, better:
// no danger of name-clashes with ALL_CAPS macros:
// consider "enum class", though
enum Coord { North, NorthEast, NorthWest, South, SouthEast, SouthWest, East, West };

The lack of a positive example allows newcomers to come to the conclusion that instead of "SOME_NAME" they should use the same naming conventions for local variables and for global ones. While nowhere as bad as having an accidental macro substitution wreak havoc in a seemingly harmless peace of code, this could still lead to unintended hiding. Ex.:

namespace {
constexpr int SPECIAL_VALUE = 42; // bad, all caps
constexpr int specialValue = 42; // better
constexpr int c_specialValue = 42; // even better, visualizes global scope
}

My examples may not be the best, but I hope I've made my point...

Search the repository for the ES.9 guideline and inspect its existing Example section. Rename that section to “Example, bad,” add a clearly labeled positive example based on the issue, and verify that the rendered guideline distinguishes the bad and better naming examples.