update of the project documentation

Spend some time updating and reviewing stuff. Please review and let me know what you think.

Thijs