Improve documentation

In this merge request, the changes are:

• Add README.md with requirements, notes
• Add more comments, sections, minor cleaning and relocate for the notebooks

If the branch xing is not needed anymore, perhaps I could also clean it up?