Clearly describe the documentation issue

We should use dashed idents in our examples of custom constructs to align with the specs (see example 7), e.g. @--custom rather than @custom.

This is in line with Stylelint's emphasis on standard CSS in our rules and docs.

Ref: #5520 (comment)

• At-rules
• Functions
• Units
• Selectors