cleanup & review of sources
updating documentation (via Sami)