add yard gem, mark private api and add a couple of examples to docs [skip ci]
small refactor of broadcaster method for readable, add docs and return configuration
add regexp support to `on` argument [#79]