add documentation, simplify
shorented name for transmission event container to "transmitted"