docs: Improve wording of intro paragraphs
docs: Improve wording of intro paragraphs

This is a general readability improvement. The meaning of these
paragraphs has not changed.

simplesamlphp/simplesamlphp,dnmvisser/simplesamlphp,ghalse/simplesamlphp,simplesamlphp/simplesamlphp,dnmvisser/simplesamlphp,simplesamlphp/simplesamlphp,dnmvisser/simplesamlphp,ghalse/simplesamlphp,simplesamlphp/simplesamlphp,dnmvisser/simplesamlphp,ghalse/simplesamlphp,ghalse/simplesamlphp