Documentation extension

This issue fixes some typos in the README.md and tutorial.
Introduced a troubleshooting section for line profiles with 3/5 peaks.
Further explanations in README.md, paper.md and tutorial.