Cleaned up docs

I didn't change much apart from deleting the warning from the top of `build_spec.rst` and removing the tutorial, which was just a broken link.