updated docs for effects