updated docs and some channel api