RD|PM: refactor - improve docs around manual triggers + add tests