updated docs with #227 related stuff