Draft spec with comments

This is a work in progress.  I am going through the draft and adding
comments where I find issues.