Update to header guard section.

The requirement for how it should be is now presented first. Also OpenSim mostly conforms to the proper header guard naming convention except for classes we plan to deprecate, so removed stale discussion about how wrong OpenSim is.