tons of fixes to reformation docs

OH MY GOSH THERE ARE A BEAR!