more inline documentation (closed #35)