a better way of documenting pubsub channels