The definitions and usage notes in Canonical are generally better than those in the pattern.  As we start to ask people to align with the patterns, we want the content there to be 'correct'.