From a5edd69ec33bba8e4a73d3afafc5c40fb280a590 Mon Sep 17 00:00:00 2001
From: Maxim Sokolov <maxim0xff@gmail.com>
Date: Wed, 26 Aug 2015 10:46:17 +0300
Subject: [PATCH] :memo: Update docs for Gutter events

---
 src/gutter.coffee | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/src/gutter.coffee b/src/gutter.coffee
index 23012b9f1..90e5feb29 100644
--- a/src/gutter.coffee
+++ b/src/gutter.coffee
@@ -25,16 +25,20 @@ class Gutter
       @emitter.emit 'did-destroy'
       @emitter.dispose()
 
-  # Calls your `callback` when the {Gutter}'s' visibility changes.
+  ###
+  Section: Event Subscription
+  ###
+
+  # Public: Calls your `callback` when the gutter's visibility changes.
   #
   # * `callback` {Function}
-  #  * `gutter` The {Gutter} whose visibility changed.
+  #  * `gutter` The gutter whose visibility changed.
   #
   # Returns a {Disposable} on which `.dispose()` can be called to unsubscribe.
   onDidChangeVisible: (callback) ->
     @emitter.on 'did-change-visible', callback
 
-  # Calls your `callback` when the {Gutter} is destroyed
+  # Public: Calls your `callback` when the gutter is destroyed.
   #
   # * `callback` {Function}
   #