Clarify documentation for MetricAlarm dimensions

Fixes #1803 and provides a better example.