tweaks to impove 2.0 docs