Doc fixes

Some time ago I read the narrative part of the Pyramid docs on an Ereader and made annotations where I noticed mistakes or things that weren't very clear. This series of commits is the result of that.