split upgrade instructions into their own file
remove weird tagline
edit docs
boil down text
shorten publish headlines
rearrange build.rst to be a little more logical