spec: Rewrite, reshape, reform! (Markdown)

Change-Id: I4eae6e6719242524d9d9f770e2701f302dd40cd8
Merge "spec: Rewrite, reshape, reform! (Markdown)"