closes #420 updated docs on `trigger` method