slack-ruby-client 0.14.1 → 0.14.2

data/bin/commands/im.rb

@@ -1,9 +1,9 @@
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'Get info on your direct messages.'
+desc 'Im methods.'
 command 'im' do |g|
-  g.desc 'Close a direct message channel.'
-  g.long_desc %( Close a direct message channel. )
+  g.desc 'This method closes a direct message channel.'
+  g.long_desc %( This method closes a direct message channel. )
   g.command 'close' do |c|
     c.flag 'channel', desc: 'Direct message channel to close.'
     c.action do |_global_options, options, _args|
@@ -11,8 +11,8 @@ command 'im' do |g|
     end
   end
 
-  g.desc 'Fetches history of messages and events from direct message channel.'
-  g.long_desc %( Fetches history of messages and events from direct message channel. )
+  g.desc 'This method returns a portion of messages/events from the specified direct message channel.'
+  g.long_desc %( This method returns a portion of messages/events from the specified direct message channel. To read the entire history for a direct message channel, call the method with no latest or oldest arguments, and then continue paging using the instructions below. )
   g.command 'history' do |c|
     c.flag 'channel', desc: 'Direct message channel to fetch history for.'
     c.flag 'inclusive', desc: 'Include messages with latest or oldest timestamp in results.'
@@ -24,8 +24,8 @@ command 'im' do |g|
     end
   end
 
-  g.desc 'Lists direct message channels for the calling user.'
-  g.long_desc %( Lists direct message channels for the calling user. )
+  g.desc "Don't use this method. Use conversations.list instead."
+  g.long_desc %( Don't use this method. Use conversations.list instead. )
   g.command 'list' do |c|
     c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail."
     c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the users list hasn't been reached."
@@ -34,8 +34,8 @@ command 'im' do |g|
     end
   end
 
-  g.desc 'Sets the read cursor in a direct message channel.'
-  g.long_desc %( Sets the read cursor in a direct message channel. )
+  g.desc 'This method moves the read cursor in a direct message channel.'
+  g.long_desc %( This method moves the read cursor in a direct message channel. )
   g.command 'mark' do |c|
     c.flag 'channel', desc: 'Direct message channel to set reading cursor in.'
     c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
@@ -44,8 +44,8 @@ command 'im' do |g|
     end
   end
 
-  g.desc 'Opens a direct message channel.'
-  g.long_desc %( Opens a direct message channel. )
+  g.desc 'This method opens a direct message channel with another member of your Slack team.'
+  g.long_desc %( This method opens a direct message channel with another member of your Slack team. )
   g.command 'open' do |c|
     c.flag 'user', desc: 'User to open a direct message channel with.'
     c.flag 'include_locale', desc: 'Set this to true to receive the locale for this im. Defaults to false.'
@@ -55,8 +55,8 @@ command 'im' do |g|
     end
   end
 
-  g.desc 'Retrieve a thread of messages posted to a direct message conversation'
-  g.long_desc %( Retrieve a thread of messages posted to a direct message conversation )
+  g.desc 'This method returns an entire thread (a message plus all the messages in reply to it).'
+  g.long_desc %( This method returns an entire thread (a message plus all the messages in reply to it). )
   g.command 'replies' do |c|
     c.flag 'channel', desc: 'Direct message channel to fetch thread from.'
     c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."

data/bin/commands/migration.rb

@@ -2,8 +2,8 @@
 
 desc 'Migration methods.'
 command 'migration' do |g|
-  g.desc 'For Enterprise Grid workspaces, map local user IDs to global user IDs'
-  g.long_desc %( For Enterprise Grid workspaces, map local user IDs to global user IDs )
+  g.desc 'Easily convert your vintage user IDs to Enterprise Grid-friendly global user IDs.'
+  g.long_desc %( Easily convert your vintage user IDs to Enterprise Grid-friendly global user IDs. )
   g.command 'exchange' do |c|
     c.flag 'users', desc: 'A comma-separated list of user ids, up to 400 per request.'
     c.flag 'to_old', desc: 'Specify true to convert W global user IDs to workspace-specific U IDs. Defaults to false.'

data/bin/commands/mpim.rb

@@ -1,9 +1,9 @@
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'Get info on your multiparty direct messages.'
+desc 'Mpim methods.'
 command 'mpim' do |g|
-  g.desc 'Closes a multiparty direct message channel.'
-  g.long_desc %( Closes a multiparty direct message channel. )
+  g.desc 'This method closes a multiparty direct message channel.'
+  g.long_desc %( This method closes a multiparty direct message channel. )
   g.command 'close' do |c|
     c.flag 'channel', desc: 'MPIM to close.'
     c.action do |_global_options, options, _args|
@@ -11,8 +11,8 @@ command 'mpim' do |g|
     end
   end
 
-  g.desc 'Fetches history of messages and events from a multiparty direct message.'
-  g.long_desc %( Fetches history of messages and events from a multiparty direct message. )
+  g.desc 'This method returns a portion of messages/events from the specified multiparty direct message channel.'
+  g.long_desc %( This method returns a portion of messages/events from the specified multiparty direct message channel. To read the entire history for a multiparty direct message, call the method with no latest or oldest arguments, and then continue paging using the instructions below. )
   g.command 'history' do |c|
     c.flag 'channel', desc: 'Multiparty direct message to fetch history for.'
     c.flag 'inclusive', desc: 'Include messages with latest or oldest timestamp in results.'
@@ -24,8 +24,8 @@ command 'mpim' do |g|
     end
   end
 
-  g.desc 'Lists multiparty direct message channels for the calling user.'
-  g.long_desc %( Lists multiparty direct message channels for the calling user. )
+  g.desc "Don't use this method. Use conversations.list instead."
+  g.long_desc %( Don't use this method. Use conversations.list instead. )
   g.command 'list' do |c|
     c.flag 'cursor', desc: "Parameter for pagination. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first 'page' of the collection. See pagination for more details."
     c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached."
@@ -34,8 +34,8 @@ command 'mpim' do |g|
     end
   end
 
-  g.desc 'Sets the read cursor in a multiparty direct message channel.'
-  g.long_desc %( Sets the read cursor in a multiparty direct message channel. )
+  g.desc 'This method moves the read cursor in a multiparty direct message channel.'
+  g.long_desc %( This method moves the read cursor in a multiparty direct message channel. )
   g.command 'mark' do |c|
     c.flag 'channel', desc: 'multiparty direct message channel to set reading cursor in.'
     c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
@@ -53,8 +53,8 @@ command 'mpim' do |g|
     end
   end
 
-  g.desc 'Retrieve a thread of messages posted to a direct message conversation from a multiparty direct message.'
-  g.long_desc %( Retrieve a thread of messages posted to a direct message conversation from a multiparty direct message. )
+  g.desc 'This method returns an entire thread (a message plus all the messages in reply to it).'
+  g.long_desc %( This method returns an entire thread (a message plus all the messages in reply to it). )
   g.command 'replies' do |c|
     c.flag 'channel', desc: 'Multiparty direct message channel to fetch thread from.'
     c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."

data/bin/commands/oauth.rb

@@ -2,8 +2,8 @@
 
 desc 'Oauth methods.'
 command 'oauth' do |g|
-  g.desc 'Exchanges a temporary OAuth verifier code for an access token.'
-  g.long_desc %( Exchanges a temporary OAuth verifier code for an access token. )
+  g.desc 'This method allows you to exchange a temporary OAuth code for an API access token.'
+  g.long_desc %( This method allows you to exchange a temporary OAuth code for an API access token. )
   g.command 'access' do |c|
     c.flag 'client_id', desc: 'Issued when you created your application.'
     c.flag 'client_secret', desc: 'Issued when you created your application.'
@@ -15,8 +15,8 @@ command 'oauth' do |g|
     end
   end
 
-  g.desc 'Exchanges a temporary OAuth verifier code for a workspace token.'
-  g.long_desc %( Exchanges a temporary OAuth verifier code for a workspace token. )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'token' do |c|
     c.flag 'client_id', desc: 'Issued when you created your application.'
     c.flag 'client_secret', desc: 'Issued when you created your application.'

data/bin/commands/pins.rb

@@ -2,8 +2,8 @@
 
 desc 'Pins methods.'
 command 'pins' do |g|
-  g.desc 'Pins an item to a channel.'
-  g.long_desc %( Pins an item to a channel. )
+  g.desc 'This method pins an item (file, file comment, channel message, or group message) to a particular channel.'
+  g.long_desc %( This method pins an item (file, file comment, channel message, or group message) to a particular channel. The channel argument is required and one of file, file_comment, or timestamp must also be specified. )
   g.command 'add' do |c|
     c.flag 'channel', desc: 'Channel to pin the item in.'
     c.flag 'file', desc: 'File to pin.'
@@ -14,8 +14,8 @@ command 'pins' do |g|
     end
   end
 
-  g.desc 'Lists items pinned to a channel.'
-  g.long_desc %( Lists items pinned to a channel. )
+  g.desc 'This method lists the items pinned to a channel.'
+  g.long_desc %( This method lists the items pinned to a channel. )
   g.command 'list' do |c|
     c.flag 'channel', desc: 'Channel to get pinned items for.'
     c.action do |_global_options, options, _args|
@@ -23,8 +23,8 @@ command 'pins' do |g|
     end
   end
 
-  g.desc 'Un-pins an item from a channel.'
-  g.long_desc %( Un-pins an item from a channel. )
+  g.desc 'This method un-pins an item (file, file comment, channel message, or group message) from a channel.'
+  g.long_desc %( This method un-pins an item (file, file comment, channel message, or group message) from a channel. The channel argument is required and one of file, file_comment, or timestamp must also be specified. )
   g.command 'remove' do |c|
     c.flag 'channel', desc: 'Channel where the item is pinned to.'
     c.flag 'file', desc: 'File to un-pin.'

data/bin/commands/reactions.rb

@@ -2,8 +2,8 @@
 
 desc 'Reactions methods.'
 command 'reactions' do |g|
-  g.desc 'Adds a reaction to an item.'
-  g.long_desc %( Adds a reaction to an item. )
+  g.desc 'This method adds a reaction (emoji) to a message.'
+  g.long_desc %( This method adds a reaction (emoji) to a message. Now that file threads work the way you'd expect, the file and file_comment arguments are deprecated. Specify channel and timestamp instead. )
   g.command 'add' do |c|
     c.flag 'name', desc: 'Reaction (emoji) name.'
     c.flag 'channel', desc: 'Channel where the message to add reaction to was posted.'
@@ -15,8 +15,8 @@ command 'reactions' do |g|
     end
   end
 
-  g.desc 'Gets reactions for an item.'
-  g.long_desc %( Gets reactions for an item. )
+  g.desc 'This method returns a list of all reactions for a single item (file, file comment, channel message, group message, or direct message).'
+  g.long_desc %( This method returns a list of all reactions for a single item (file, file comment, channel message, group message, or direct message). )
   g.command 'get' do |c|
     c.flag 'channel', desc: 'Channel where the message to get reactions for was posted.'
     c.flag 'file', desc: 'File to get reactions for.'
@@ -28,8 +28,8 @@ command 'reactions' do |g|
     end
   end
 
-  g.desc 'Lists reactions made by a user.'
-  g.long_desc %( Lists reactions made by a user. )
+  g.desc 'This method returns a list of all items (file, file comment, channel message, group message, or direct message) reacted to by a user.'
+  g.long_desc %( This method returns a list of all items (file, file comment, channel message, group message, or direct message) reacted to by a user. )
   g.command 'list' do |c|
     c.flag 'cursor', desc: "Parameter for pagination. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first 'page' of the collection. See pagination for more details."
     c.flag 'full', desc: 'If true always return the complete reaction list.'
@@ -40,8 +40,8 @@ command 'reactions' do |g|
     end
   end
 
-  g.desc 'Removes a reaction from an item.'
-  g.long_desc %( Removes a reaction from an item. )
+  g.desc 'This method removes a reaction (emoji) from an item (file, file comment, channel message, group message, or direct message).'
+  g.long_desc %( This method removes a reaction (emoji) from an item (file, file comment, channel message, group message, or direct message). One of file, file_comment, or the combination of channel and timestamp must be specified. )
   g.command 'remove' do |c|
     c.flag 'name', desc: 'Reaction (emoji) name.'
     c.flag 'channel', desc: 'Channel where the message to remove reaction from was posted.'

data/bin/commands/reminders.rb

@@ -2,8 +2,8 @@
 
 desc 'Reminders methods.'
 command 'reminders' do |g|
-  g.desc 'Creates a reminder.'
-  g.long_desc %( Creates a reminder. )
+  g.desc 'This method creates a reminder.'
+  g.long_desc %( This method creates a reminder. )
   g.command 'add' do |c|
     c.flag 'text', desc: 'The content of the reminder.'
     c.flag 'time', desc: 'When this reminder should happen: the Unix timestamp (up to five years from now), the number of seconds until the reminder (if within 24 hours), or a natural language description (Ex. "in 15 minutes," or "every Thursday").'
@@ -13,8 +13,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'Marks a reminder as complete.'
-  g.long_desc %( Marks a reminder as complete. )
+  g.desc 'This method completes a reminder.'
+  g.long_desc %( This method completes a reminder. )
   g.command 'complete' do |c|
     c.flag 'reminder', desc: 'The ID of the reminder to be marked as complete.'
     c.action do |_global_options, options, _args|
@@ -22,8 +22,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'Deletes a reminder.'
-  g.long_desc %( Deletes a reminder. )
+  g.desc 'This method deletes a reminder.'
+  g.long_desc %( This method deletes a reminder. )
   g.command 'delete' do |c|
     c.flag 'reminder', desc: 'The ID of the reminder.'
     c.action do |_global_options, options, _args|
@@ -31,8 +31,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'Gets information about a reminder.'
-  g.long_desc %( Gets information about a reminder. )
+  g.desc 'This method returns information about a reminder.'
+  g.long_desc %( This method returns information about a reminder. )
   g.command 'info' do |c|
     c.flag 'reminder', desc: 'The ID of the reminder.'
     c.action do |_global_options, options, _args|
@@ -40,8 +40,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'Lists all reminders created by or for a given user.'
-  g.long_desc %( Lists all reminders created by or for a given user. )
+  g.desc 'This method lists all reminders created by or for a given user.'
+  g.long_desc %( This method lists all reminders created by or for a given user. )
   g.command 'list' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reminders_list(options))

data/bin/commands/rtm.rb

@@ -2,8 +2,8 @@
 
 desc 'Rtm methods.'
 command 'rtm' do |g|
-  g.desc 'Starts a Real Time Messaging session.'
-  g.long_desc %( Starts a Real Time Messaging session. )
+  g.desc 'This method begins a Real Time Messaging API session and reserves your application a specific URL with which to connect via websocket.'
+  g.long_desc %( This method begins a Real Time Messaging API session and reserves your application a specific URL with which to connect via websocket. )
   g.command 'connect' do |c|
     c.flag 'batch_presence_aware', desc: 'Batch presence deliveries via subscription. Enabling changes the shape of presence_change events. See batch presence.'
     c.flag 'presence_sub', desc: 'Only deliver presence events when requested by subscription. See presence subscriptions.'
@@ -12,8 +12,8 @@ command 'rtm' do |g|
     end
   end
 
-  g.desc 'Starts a Real Time Messaging session.'
-  g.long_desc %( Starts a Real Time Messaging session. )
+  g.desc 'This method begins a Real Time Messaging API session and reserves your application a specific URL with which to connect via websocket.'
+  g.long_desc %( This method begins a Real Time Messaging API session and reserves your application a specific URL with which to connect via websocket. )
   g.command 'start' do |c|
     c.flag 'batch_presence_aware', desc: 'Batch presence deliveries via subscription. Enabling changes the shape of presence_change events. See batch presence.'
     c.flag 'include_locale', desc: 'Set this to true to receive the locale for users and channels. Defaults to false.'

data/bin/commands/search.rb

@@ -1,9 +1,9 @@
 # This file was auto-generated by lib/tasks/web.rake
 
-desc "Search your team's files and messages."
+desc 'Search methods.'
 command 'search' do |g|
-  g.desc 'Searches for messages and files matching a query.'
-  g.long_desc %( Searches for messages and files matching a query. )
+  g.desc 'This method allows users and applications to search both messages and files in a single call.'
+  g.long_desc %( This method allows users and applications to search both messages and files in a single call. )
   g.command 'all' do |c|
     c.flag 'query', desc: 'Search query. May contains booleans, etc.'
     c.flag 'highlight', desc: 'Pass a value of true to enable query highlight markers (see below).'
@@ -14,8 +14,8 @@ command 'search' do |g|
     end
   end
 
-  g.desc 'Searches for files matching a query.'
-  g.long_desc %( Searches for files matching a query. )
+  g.desc 'This method returns files matching a search query.'
+  g.long_desc %( This method returns files matching a search query. )
   g.command 'files' do |c|
     c.flag 'query', desc: 'Search query.'
     c.flag 'highlight', desc: 'Pass a value of true to enable query highlight markers (see below).'
@@ -26,8 +26,8 @@ command 'search' do |g|
     end
   end
 
-  g.desc 'Searches for messages matching a query.'
-  g.long_desc %( Searches for messages matching a query. )
+  g.desc 'This method returns messages matching a search query.'
+  g.long_desc %( This method returns messages matching a search query. )
   g.command 'messages' do |c|
     c.flag 'query', desc: 'Search query.'
     c.flag 'highlight', desc: 'Pass a value of true to enable query highlight markers (see below).'

data/bin/commands/stars.rb

@@ -2,8 +2,8 @@
 
 desc 'Stars methods.'
 command 'stars' do |g|
-  g.desc 'Adds a star to an item.'
-  g.long_desc %( Adds a star to an item. )
+  g.desc 'This method adds a star to an item (message, file, file comment, channel, private group, or DM) on behalf of the authenticated user.'
+  g.long_desc %( This method adds a star to an item (message, file, file comment, channel, private group, or DM) on behalf of the authenticated user. One of file, file_comment, channel, or the combination of channel and timestamp must be specified. )
   g.command 'add' do |c|
     c.flag 'channel', desc: 'Channel to add star to, or channel where the message to add star to was posted (used with timestamp).'
     c.flag 'file', desc: 'File to add star to.'
@@ -14,8 +14,8 @@ command 'stars' do |g|
     end
   end
 
-  g.desc 'Lists stars for a user.'
-  g.long_desc %( Lists stars for a user. )
+  g.desc 'This method lists the items starred by the authed user.'
+  g.long_desc %( This method lists the items starred by the authed user. )
   g.command 'list' do |c|
     c.flag 'cursor', desc: "Parameter for pagination. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first 'page' of the collection. See pagination for more details."
     c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached."
@@ -24,8 +24,8 @@ command 'stars' do |g|
     end
   end
 
-  g.desc 'Removes a star from an item.'
-  g.long_desc %( Removes a star from an item. )
+  g.desc 'This method removes a star from an item (message, file, file comment, channel, private group, or DM) on behalf of the authenticated user.'
+  g.long_desc %( This method removes a star from an item (message, file, file comment, channel, private group, or DM) on behalf of the authenticated user. One of file, file_comment, channel, or the combination of channel and timestamp must be specified. )
   g.command 'remove' do |c|
     c.flag 'channel', desc: 'Channel to remove star from, or channel where the message to remove star from was posted (used with timestamp).'
     c.flag 'file', desc: 'File to remove star from.'

data/bin/commands/team.rb

@@ -2,8 +2,8 @@
 
 desc 'Team methods.'
 command 'team' do |g|
-  g.desc 'Gets the access logs for the current team.'
-  g.long_desc %( Gets the access logs for the current team. )
+  g.desc 'This method is used to retrieve the "access logs" for users on a workspace.'
+  g.long_desc %( This method is used to retrieve the "access logs" for users on a workspace. )
   g.command 'accessLogs' do |c|
     c.flag 'before', desc: 'End of time range of logs to include in results (inclusive).'
     c.action do |_global_options, options, _args|
@@ -11,8 +11,8 @@ command 'team' do |g|
     end
   end
 
-  g.desc 'Gets billable users information for the current team.'
-  g.long_desc %( Gets billable users information for the current team. )
+  g.desc 'This method lists billable information for each user on the team. Currently this consists solely of whether the user is'
+  g.long_desc %( This method lists billable information for each user on the team. Currently this consists solely of whether the user is subject to billing per Slack's Fair Billing policy. )
   g.command 'billableInfo' do |c|
     c.flag 'user', desc: 'A user to retrieve the billable information for. Defaults to all users.'
     c.action do |_global_options, options, _args|
@@ -20,16 +20,16 @@ command 'team' do |g|
     end
   end
 
-  g.desc 'Gets information about the current team.'
-  g.long_desc %( Gets information about the current team. )
+  g.desc 'This method provides information about your team.'
+  g.long_desc %( This method provides information about your team. )
   g.command 'info' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.team_info(options))
     end
   end
 
-  g.desc 'Gets the integration logs for the current team.'
-  g.long_desc %( Gets the integration logs for the current team. )
+  g.desc 'This method lists the integration activity logs for a team, including when integrations are added, modified and removed. This method can only be called by Admins.'
+  g.long_desc %( This method lists the integration activity logs for a team, including when integrations are added, modified and removed. This method can only be called by Admins. )
   g.command 'integrationLogs' do |c|
     c.flag 'app_id', desc: 'Filter logs to this Slack app. Defaults to all logs.'
     c.flag 'change_type', desc: 'Filter logs with this change type. Defaults to all logs.'

data/bin/commands/team_profile.rb

@@ -2,8 +2,8 @@
 
 desc 'TeamProfile methods.'
 command 'team_profile' do |g|
-  g.desc "Retrieve a team's profile."
-  g.long_desc %( Retrieve a team's profile. )
+  g.desc 'This method is used to get the profile field definitions for this team.'
+  g.long_desc %( This method is used to get the profile field definitions for this team. )
   g.command 'get' do |c|
     c.flag 'visibility', desc: 'Filter by visibility.'
     c.action do |_global_options, options, _args|

data/bin/commands/usergroups.rb

@@ -1,9 +1,9 @@
 # This file was auto-generated by lib/tasks/web.rake
 
-desc "Get info on your team's User Groups."
+desc 'Usergroups methods.'
 command 'usergroups' do |g|
-  g.desc 'Create a User Group'
-  g.long_desc %( Create a User Group )
+  g.desc 'This method is used to create a User Group.'
+  g.long_desc %( This method is used to create a User Group. )
   g.command 'create' do |c|
     c.flag 'name', desc: 'A name for the User Group. Must be unique among User Groups.'
     c.flag 'channels', desc: 'A comma separated string of encoded channel IDs for which the User Group uses as a default.'
@@ -15,8 +15,8 @@ command 'usergroups' do |g|
     end
   end
 
-  g.desc 'Disable an existing User Group'
-  g.long_desc %( Disable an existing User Group )
+  g.desc 'This method disables an existing User Group.'
+  g.long_desc %( This method disables an existing User Group. )
   g.command 'disable' do |c|
     c.flag 'usergroup', desc: 'The encoded ID of the User Group to disable.'
     c.flag 'include_count', desc: 'Include the number of users in the User Group.'
@@ -25,8 +25,8 @@ command 'usergroups' do |g|
     end
   end
 
-  g.desc 'Enable a User Group'
-  g.long_desc %( Enable a User Group )
+  g.desc 'This method enables a User Group which was previously disabled.'
+  g.long_desc %( This method enables a User Group which was previously disabled. )
   g.command 'enable' do |c|
     c.flag 'usergroup', desc: 'The encoded ID of the User Group to enable.'
     c.flag 'include_count', desc: 'Include the number of users in the User Group.'
@@ -35,8 +35,8 @@ command 'usergroups' do |g|
     end
   end
 
-  g.desc 'List all User Groups for a team'
-  g.long_desc %( List all User Groups for a team )
+  g.desc 'This method returns a list of all User Groups in the team. This can optionally include disabled User Groups.'
+  g.long_desc %( This method returns a list of all User Groups in the team. This can optionally include disabled User Groups. )
   g.command 'list' do |c|
     c.flag 'include_count', desc: 'Include the number of users in each User Group.'
     c.flag 'include_disabled', desc: 'Include disabled User Groups.'
@@ -46,8 +46,8 @@ command 'usergroups' do |g|
     end
   end
 
-  g.desc 'Update an existing User Group'
-  g.long_desc %( Update an existing User Group )
+  g.desc 'This method updates the properties of an existing User Group.'
+  g.long_desc %( This method updates the properties of an existing User Group. )
   g.command 'update' do |c|
     c.flag 'usergroup', desc: 'The encoded ID of the User Group to update.'
     c.flag 'channels', desc: 'A comma separated string of encoded channel IDs for which the User Group uses as a default.'