What do we want to see from spec authors?

[lolaodelola]

Related to the parent issue, once we know what parts of the doc we want to focus on, we should also highlight good examples showing the kind of information and level of detail we'd want to see from spec authors.