Improve docs for & and |>, closes #2125