Ported spec to markdown, cosmetic changes.