added code-magic draft. it has an introduction blurb
added "the good" section
made the rspec example use repo in comments instead of repository
added id in rspec example