diff --git a/docs/logging.md b/docs/logging.md
index 102b06a9b..f5e509f7a 100644
--- a/docs/logging.md
+++ b/docs/logging.md
@@ -9,6 +9,67 @@ events:on                                       Enable events logger
 events:off                                      Disable events logger
 ```
 
-## System logs
+## Usage
 
-The _events_ plugin writes log entries to ``/var/log/syslog`` as well as a Dokku-specific logs sub-directory ``/var/log/dokku/events.log``.
+Enable the plugin:
+
+```
+$ dokku events:on
+Enabling dokku events logger
+```
+
+It writes log entries to ``/var/log/syslog`` as well as a Dokku-specific logs sub-directory ``/var/log/dokku/events.log``, which can be easily displayed:
+
+```
+$ dokku events
+Jul  3 16:09:48 dokku.me dokku[127630]: INVOKED: pre-release-buildstep( pythonapp )
+Jul  3 16:10:02 dokku.me dokku[128095]: INVOKED: docker-args-run( rubyapp )
+Jul  3 16:10:02 dokku.me dokku[128114]: INVOKED: docker-args-run( nhl )
+Jul  3 16:10:03 dokku.me dokku[128136]: INVOKED: post-release-buildstep( pythonapp )
+Jul  3 16:10:03 dokku.me dokku[128195]: INVOKED: pre-deploy( pythonapp )
+Jul  3 16:10:23 dokku.me dokku[129253]: INVOKED: docker-args-deploy( pythonapp )
+Jul  3 16:10:24 dokku.me dokku[129337]: INVOKED: bind-external-ip( pythonapp )
+Jul  3 16:10:24 dokku.me dokku[129451]: INVOKED: check-deploy( pythonapp 6274ced0d4be11af4490cd18abaf77cdd593f025133f403d984e80d86a39acec web 5000 10.0.16.80 )
+Jul  3 16:10:35 dokku.me dokku[129561]: INVOKED: docker-args-deploy( pythonapp )
+Jul  3 16:10:35 dokku.me dokku[129649]: INVOKED: bind-external-ip( pythonapp )
+Jul  3 16:10:36 dokku.me dokku[129760]: INVOKED: check-deploy( pythonapp ac88a56ee4161ff37e4b92d1498c3eadc91f0aa7c8b81b44fc077e2a51d54cc0 worker )
+Jul  3 16:10:46 dokku.me dokku[129851]: INVOKED: post-deploy( pythonapp )
+Jul  3 16:10:46 dokku.me dokku[129945]: INVOKED: nginx-pre-reload( pythonapp )
+Jul  3 16:15:02 dokku.me dokku[130397]: INVOKED: docker-args-run( goapp )
+Jul  3 16:21:02 dokku.me dokku[130796]: INVOKED: docker-args-run( rubyapp )
+Jul  3 16:30:02 dokku.me dokku[131384]: INVOKED: docker-args-run( rubyapp )
+```
+
+List all events that are currently being recored:
+```
+& dokku events:list
+=====> Events currently logged                                                                              
+backup-check                                                                                           
+docker-args-build                                                                                      
+pre-delete                                                                                             
+post-deploy                                                                                            
+receive-app                                                                                            
+pre-release-buildstep                                                                                  
+nginx-pre-reload                                                                                       
+docker-args-deploy                                                                                     
+post-build-buildstep                                                                                   
+post-domains-update                                                                                    
+post-release-dockerfile                                                                                
+check-deploy                                                                                           
+backup-import                                                                                          
+backup-export                                                                                          
+git-pre-pull                                                                                           
+git-post-pull                                                                                          
+nginx-hostname                                                                                         
+bind-external-ip                                                                                       
+pre-deploy                                                                                             
+post-delete                                                                                            
+dependencies                                                                                           
+pre-build-buildstep                                                                                    
+docker-args-run                                                                                        
+pre-build-dockerfile                                                                                   
+post-release-buildstep                                                                                 
+post-build-dockerfile                                                                                  
+pre-release-dockerfile
+update
+```