Change definition of summary/description break

In this commit I have made the following documentation changes:

- Changed short description to summary
- Changed long description to description
- Changed example mail address
- Changed definition when a summary breaks and becomes a description
  to match PSR-5 and actual usage.
Integrated code review feedback
Fix feedback on PR
Merge pull request #1353 from mvriel/feature/RD-34

Change definition of summary/description break