add docs, spec for custom channels