DOC: updated based on comments from @ElDeveloper