working on documentation
relates #18