Again another huge update to the documentation.Still incomplete, though.
introduced activity diagrams for the publish-subscribe system.(state diagrams are deprecated and will be removed soon)