Add inline docs for common.yaml

The common.yaml file lacks inline documentation, which makes it harder
for users to understand.  This patch adds inline documentation to
make the file more self-documenting.

Change-Id: Iba98f2a829ff9b5b8ae6d2242544f0507866567c
Partial-Bug: #1270381