From 1a98e9235aafbafb4c8dbdefadb6d4a7df98d55d Mon Sep 17 00:00:00 2001
From: Rapptz <rapptz@gmail.com>
Date: Fri, 25 Mar 2016 22:51:03 -0400
Subject: [PATCH] Clarify Channel.position documentation.

---
 discord/channel.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/discord/channel.py b/discord/channel.py
index 11f6b722f..b63a27c8a 100644
--- a/discord/channel.py
+++ b/discord/channel.py
@@ -62,7 +62,10 @@ class Channel(Hashable):
     is_private : bool
         ``True`` if the channel is a private channel (i.e. PM). ``False`` in this case.
     position : int
-        The position in the channel list.
+        The position in the channel list. This is a number that starts at 0. e.g. the
+        top channel is position 0. The position varies depending on being a voice channel
+        or a text channel, so a 0 position voice channel is on top of the voice channel
+        list.
     type : :class:`ChannelType`
         The channel type. There is a chance that the type will be ``str`` if
         the channel type is not within the ones recognised by the enumerator.