DOC: clarified doc
INST: updated files