add DOC + minor fixes