[#8] follow-up on commit 6c2362fd31e1925e5702b5b7967ccd311df4d741

also fixed documentation