Update documentation to reflect (anticipated) v0.5.0

First draft for documentation update. A separate SBT-plugin page will follow.
"In general" -> "Most of the time"? I believe the former means more "always" than "most of the time".