chg: more doc
fix: adapt plugins behavior to documentation