DOC: made changes suggested by @jairideout