fix the pull request links and add specs

Signed-off-by: Zach Robinson <zrobinson@pivotallabs.com>