doc updates (mainly style improvements)

core of the doc... still hasn't really been started