cleanup & review of sources
updating documentation