added more documentation for json channel spec