Add spec documentation
Add links to writing specs doc
Merge pull request #2339 from atom/cj-add-spec-documentation

Add spec documentation