documentation update, THX @catlan

fixes GH-5