diff --git a/src/structures/GuildMember.js b/src/structures/GuildMember.js
index f2fac38b4..cfa1ea155 100644
--- a/src/structures/GuildMember.js
+++ b/src/structures/GuildMember.js
@@ -280,7 +280,8 @@ class GuildMember {
   }
 
   /**
-   * Returns `channel.permissionsFor(guildMember)`. Returns evaluated permissions for a member in a guild channel.
+   * Returns `channel.permissionsFor(guildMember)`. Returns permissions for a member in a guild channel,
+   * taking into account roles and permission overwrites.
    * @param {ChannelResolvable} channel Guild channel to use as context
    * @returns {?Permissions}
    */
diff --git a/src/structures/Role.js b/src/structures/Role.js
index 6d1556b41..d2ec8814d 100644
--- a/src/structures/Role.js
+++ b/src/structures/Role.js
@@ -55,7 +55,7 @@ class Role {
     this.position = data.position;
 
     /**
-     * The evaluated permissions number
+     * The permissions bitfield of the role
      * @type {number}
      */
     this.permissions = data.permissions;