rst cleanup

fixed layout and other minor rst translation challenges.