added initial documentation about events
Reorganized README and architecture information