DOC: corrected Ariel's suggestions