Change on_server_create/delete to on_server_join/remove.

2 files changed, 21 insertions, 8 deletions

diff --git a/discord/client.py b/discord/client.py
index 67990698..5e47b149 100644
--- a/discord/client.py
+++ b/discord/client.py
@@ -348,7 +348,7 @@ class ConnectionState(object):
             # available, so it isn't in the cache...
 
         self._add_server(data)
-        self.dispatch('server_create', self.servers[-1])
+        self.dispatch('server_join', self.servers[-1])
 
     def handle_guild_delete(self, data):
         if data.get('unavailable', False):
@@ -362,7 +362,7 @@ class ConnectionState(object):
 
         server = self._get_server(data.get('id'))
         self.servers.remove(server)
-        self.dispatch('server_delete', server)
+        self.dispatch('server_remove', server)
 
     def handle_guild_role_create(self, data):
         server = self._get_server(data.get('guild_id'))
diff --git a/docs/api.rst b/docs/api.rst
index 03100c08..5ffc9966 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -188,15 +188,28 @@ to handle it, which defaults to print a traceback and ignore the exception.
 
     :param member: The :class:`Member` that updated their profile with the updated info.
 
-.. function:: on_server_create(server)
-              on_server_delete(server)
+.. function:: on_server_join(server)
 
-    Called when a :class:`Server` is created or deleted.
+    Called when a :class:`Server` is either created by the :class:`Client` or when the
+    :class:`Client` joins a server.
 
-    Note that the server that is created must belong to the :class:`Client` and the server
-    that got deleted must have been part of the client's participating servers.
+    :param server: The class:`Server` that was joined.
 
-    :param server: The :class:`Server` that got created or deleted.
+.. function:: on_server_remove(server)
+
+    Called when a :class:`Server` is removed from the :class:`Client`.
+
+    This happens through, but not limited to, these circumstances:
+
+    - The client got banned.
+    - The client got kicked.
+    - The client left the server.
+    - The client or the server owner deleted the server.
+
+    In order for this event to be invoked then the :class:`Client` must have
+    been part of the server to begin with. (i.e. it is part of :attr:`Client.servers`)
+
+    :param server: The :class:`Server` that got removed.
 
 .. function:: on_server_role_create(server, role)
               on_server_role_delete(server, role)