doc updates
provide some interesting new options to channel sources