Grammar cleanup (#875)

This commit:
* fixes inconsistencies (primarily regarding capitalization)
* fixes non-proper nouns that were improperly capitalized
* fixes reminents from not-so-meticulous copy+paste jobs
This commit is contained in:
Programmix
2016-11-05 16:57:34 -07:00
committed by Amish Shah
parent 93e6c69bd1
commit fe3914658a
37 changed files with 151 additions and 150 deletions

View File

@@ -9,7 +9,7 @@ const cloneObject = require('../util/CloneObject');
const arraysEqual = require('../util/ArraysEqual');
/**
* Represents a Guild (or a Server) on Discord.
* Represents a guild (or a server) on Discord.
* <info>It's recommended to see if a guild is available before performing operations or reading data from it. You can
* check this with `guild.available`.</info>
*/
@@ -23,19 +23,19 @@ class Guild {
Object.defineProperty(this, 'client', { enumerable: false, configurable: false });
/**
* A Collection of members that are in this Guild. The key is the member's ID, the value is the member.
* A collection of members that are in this guild. The key is the member's ID, the value is the member.
* @type {Collection<string, GuildMember>}
*/
this.members = new Collection();
/**
* A Collection of channels that are in this Guild. The key is the channel's ID, the value is the channel.
* A collection of channels that are in this guild. The key is the channel's ID, the value is the channel.
* @type {Collection<string, GuildChannel>}
*/
this.channels = new Collection();
/**
* A Collection of roles that are in this Guild. The key is the role's ID, the value is the role.
* A collection of roles that are in this guild. The key is the role's ID, the value is the role.
* @type {Collection<string, Role>}
*/
this.roles = new Collection();
@@ -43,7 +43,7 @@ class Guild {
if (!data) return;
if (data.unavailable) {
/**
* Whether the Guild is available to access. If it is not available, it indicates a server outage.
* Whether the guild is available to access. If it is not available, it indicates a server outage.
* @type {boolean}
*/
this.available = false;
@@ -90,7 +90,7 @@ class Guild {
this.region = data.region;
/**
* The full amount of members in this Guild as of `READY`
* The full amount of members in this guild as of `READY`
* @type {number}
*/
this.memberCount = data.member_count || this.memberCount;
@@ -102,7 +102,7 @@ class Guild {
this.large = data.large || this.large;
/**
* A collection of presences in this Guild
* A collection of presences in this guild
* @type {Collection<string, Presence>}
*/
this.presences = new Collection();
@@ -114,7 +114,7 @@ class Guild {
this.features = data.features;
/**
* A Collection of emojis that are in this Guild. The key is the emoji's ID, the value is the emoji.
* A collection of emojis that are in this guild. The key is the emoji's ID, the value is the emoji.
* @type {Collection<string, Emoji>}
*/
this.emojis = new Collection();
@@ -242,7 +242,7 @@ class Guild {
}
/**
* The owner of the Guild
* The owner of the guild
* @type {GuildMember}
* @readonly
*/
@@ -269,7 +269,7 @@ class Guild {
}
/**
* Returns the GuildMember form of a User object, if the User is present in the guild.
* Returns the GuildMember form of a User object, if the user is present in the guild.
* @param {UserResolvable} user The user that you want to obtain the GuildMember of
* @returns {?GuildMember}
* @example
@@ -281,7 +281,7 @@ class Guild {
}
/**
* Fetch a Collection of banned users in this Guild.
* Fetch a collection of banned users in this guild.
* @returns {Promise<Collection<string, User>>}
*/
fetchBans() {
@@ -289,7 +289,7 @@ class Guild {
}
/**
* Fetch a Collection of invites to this Guild. Resolves with a Collection mapping invites by their codes.
* Fetch a collection of invites to this guild. Resolves with a collection mapping invites by their codes.
* @returns {Promise<Collection<string, Invite>>}
*/
fetchInvites() {
@@ -318,7 +318,7 @@ class Guild {
}
/**
* Fetches all the members in the Guild, even if they are offline. If the Guild has less than 250 members,
* Fetches all the members in the guild, even if they are offline. If the guild has less than 250 members,
* this should not be necessary.
* @param {string} [query=''] An optional query to provide when fetching members
* @returns {Promise<Guild>}
@@ -375,8 +375,8 @@ class Guild {
}
/**
* Edit the name of the Guild.
* @param {string} name The new name of the Guild
* Edit the name of the guild.
* @param {string} name The new name of the guild
* @returns {Promise<Guild>}
* @example
* // edit the guild name
@@ -389,7 +389,7 @@ class Guild {
}
/**
* Edit the region of the Guild.
* Edit the region of the guild.
* @param {string} region The new region of the guild.
* @returns {Promise<Guild>}
* @example
@@ -403,7 +403,7 @@ class Guild {
}
/**
* Edit the verification level of the Guild.
* Edit the verification level of the guild.
* @param {number} verificationLevel The new verification level of the guild
* @returns {Promise<Guild>}
* @example
@@ -417,7 +417,7 @@ class Guild {
}
/**
* Edit the AFK channel of the Guild.
* Edit the AFK channel of the guild.
* @param {GuildChannelResolvable} afkChannel The new AFK channel
* @returns {Promise<Guild>}
* @example
@@ -431,7 +431,7 @@ class Guild {
}
/**
* Edit the AFK timeout of the Guild.
* Edit the AFK timeout of the guild.
* @param {number} afkTimeout The time in seconds that a user must be idle to be considered AFK
* @returns {Promise<Guild>}
* @example
@@ -445,7 +445,7 @@ class Guild {
}
/**
* Set a new Guild Icon.
* Set a new guild icon.
* @param {Base64Resolvable} icon The new icon of the guild
* @returns {Promise<Guild>}
* @example
@@ -459,8 +459,8 @@ class Guild {
}
/**
* Sets a new owner of the Guild.
* @param {GuildMemberResolvable} owner The new owner of the Guild
* Sets a new owner of the guild.
* @param {GuildMemberResolvable} owner The new owner of the guild
* @returns {Promise<Guild>}
* @example
* // edit the guild owner
@@ -473,7 +473,7 @@ class Guild {
}
/**
* Set a new Guild Splash Logo.
* Set a new guild splash screen.
* @param {Base64Resolvable} splash The new splash screen of the guild
* @returns {Promise<Guild>}
* @example
@@ -503,7 +503,7 @@ class Guild {
}
/**
* Unbans a user from the Guild.
* Unbans a user from the guild.
* @param {UserResolvable} user The user to unban
* @returns {Promise<User>}
* @example
@@ -546,7 +546,7 @@ class Guild {
}
/**
* Creates a new Channel in the Guild.
* Creates a new channel in the guild.
* @param {string} name The name of the new channel
* @param {string} type The type of the new channel, either `text` or `voice`
* @returns {Promise<TextChannel|VoiceChannel>}
@@ -702,7 +702,7 @@ class Guild {
}
/**
* When concatenated with a string, this automatically concatenates the Guild's name instead of the Guild object.
* When concatenated with a string, this automatically concatenates the guild's name instead of the Guild object.
* @returns {string}
* @example
* // logs: Hello from My Guild!
@@ -757,7 +757,7 @@ class Guild {
if (this.client.ws.status === Constants.Status.READY && notSame) {
/**
* Emitted whenever a Guild Member changes - i.e. new role, removed role, nickname
* Emitted whenever a guild member changes - i.e. new role, removed role, nickname
* @event Client#guildMemberUpdate
* @param {GuildMember} oldMember The member before the update
* @param {GuildMember} newMember The member after the update
@@ -781,7 +781,7 @@ class Guild {
if (member && member.speaking !== speaking) {
member.speaking = speaking;
/**
* Emitted once a Guild Member starts/stops speaking
* Emitted once a guild member starts/stops speaking
* @event Client#guildMemberSpeaking
* @param {GuildMember} member The member that started/stopped speaking
* @param {boolean} speaking Whether or not the member is speaking