first cut of the docs for typed channels