Update docs

@basarat

I cleaned up the documentation a bit and updated the default compiler flags to match.