Added note to place login/logout route definitions before `/{pagename}` route

Resolves https://github.com/Pylons/pyramid/issues/1274
Corrected inline markup to use * for italics
Merge pull request #1275 from thapar/patch-3

Added note to place login/logout route definitions before `/{pagename}` ...