fix markup
replace a sentence that doesn't quite fit

It's as if pyramid_traversalwrapper was already introduced.
fix some cross-references
Merge pull request #971 from tshepang/diff

some doc improvements