capitalize
avoid needless repetition

These are already stated on the function definition.
Merge pull request #822 from tshepang/session

some pyramid.session API doc improvements