Improve authentication documentation

[ravage84]

Various improvements

• Formatting
• Wording
• Grammar error
• Code, class name & path highlighing
• Namings
• De-emphasize less importaant remarks
• Update broken links

[ravage84]

@TerryKern can you have a look at this, please?

[rochamarcelo]

Thank you.