refactoring in channels. documentation updated. new document (broker
definition) added