GH #569: update documentation