slack-ruby-client 0.14.2 → 0.15.0

data/bin/commands/migration.rb

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Migration methods.'
 command 'migration' do |g|
-  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.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.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,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Mpim methods.'
 command 'mpim' do |g|
-  g.desc 'This method closes a multiparty direct message channel.'
-  g.long_desc %( This method closes a multiparty direct message channel. )
+  g.desc 'Closes a multiparty direct message channel.'
+  g.long_desc %( 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 +12,8 @@ command 'mpim' do |g|
     end
   end
 
-  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.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.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 +25,8 @@ command 'mpim' do |g|
     end
   end
 
-  g.desc "Don't use this method. Use conversations.list instead."
-  g.long_desc %( Don't use this method. Use conversations.list instead. )
+  g.desc 'Lists multiparty direct message channels for the calling user.'
+  g.long_desc %( Lists multiparty direct message channels for the calling 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."
@@ -34,8 +35,8 @@ command 'mpim' do |g|
     end
   end
 
-  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.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.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 +54,8 @@ command 'mpim' do |g|
     end
   end
 
-  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.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.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

@@ -1,22 +1,23 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Oauth methods.'
 command 'oauth' do |g|
-  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.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.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.'
     c.flag 'code', desc: 'The code param returned via the OAuth callback.'
     c.flag 'redirect_uri', desc: 'This must match the originally submitted URI (if one was sent).'
-    c.flag 'single_channel', desc: 'Request the user to add your app only to a single channel.'
+    c.flag 'single_channel', desc: 'Request the user to add your app only to a single channel. Only valid with a legacy workspace app.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.oauth_access(options))
     end
   end
 
-  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.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.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/oauth_v2.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'OauthV2 methods.'
+command 'oauth_v2' 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.command 'access' do |c|
+    c.flag 'code', desc: 'The code param returned via the OAuth callback.'
+    c.flag 'client_id', desc: 'Issued when you created your application.'
+    c.flag 'client_secret', desc: 'Issued when you created your application.'
+    c.flag 'redirect_uri', desc: 'This must match the originally submitted URI (if one was sent).'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.oauth_v2_access(options))
+    end
+  end
+end

data/bin/commands/pins.rb

@@ -1,21 +1,20 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Pins methods.'
 command 'pins' do |g|
-  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.desc 'Pins an item to a channel.'
+  g.long_desc %( Pins an item to a channel. )
   g.command 'add' do |c|
     c.flag 'channel', desc: 'Channel to pin the item in.'
-    c.flag 'file', desc: 'File to pin.'
-    c.flag 'file_comment', desc: 'File comment to pin.'
     c.flag 'timestamp', desc: 'Timestamp of the message to pin.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.pins_add(options))
     end
   end
 
-  g.desc 'This method lists the items pinned to a channel.'
-  g.long_desc %( This method lists the items pinned to a channel. )
+  g.desc 'Lists items pinned to a channel.'
+  g.long_desc %( Lists 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 +22,8 @@ command 'pins' do |g|
     end
   end
 
-  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.desc 'Un-pins an item from a channel.'
+  g.long_desc %( Un-pins an item from a channel. )
   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

@@ -1,22 +1,21 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Reactions methods.'
 command 'reactions' do |g|
-  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.desc 'Adds a reaction to an item.'
+  g.long_desc %( Adds a reaction to an item. )
   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.'
-    c.flag 'file', desc: "File to add reaction to. Now that file threads work the way you'd expect, this argument is deprecated. Specify the timestamp and channel of the message associated with a file instead."
-    c.flag 'file_comment', desc: "File comment to add reaction to. Now that file threads work the way you'd expect, this argument is deprecated. Specify the timestamp and channel of the message associated with a file instead."
+    c.flag 'name', desc: 'Reaction (emoji) name.'
     c.flag 'timestamp', desc: 'Timestamp of the message to add reaction to.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reactions_add(options))
     end
   end
 
-  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.desc 'Gets reactions for an item.'
+  g.long_desc %( Gets reactions for an item. )
   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 +27,8 @@ command 'reactions' do |g|
     end
   end
 
-  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.desc 'Lists reactions made by a user.'
+  g.long_desc %( Lists reactions made 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 +39,8 @@ command 'reactions' do |g|
     end
   end
 
-  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.desc 'Removes a reaction from an item.'
+  g.long_desc %( Removes a reaction from an item. )
   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

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Reminders methods.'
 command 'reminders' do |g|
-  g.desc 'This method creates a reminder.'
-  g.long_desc %( This method creates a reminder. )
+  g.desc 'Creates a reminder.'
+  g.long_desc %( 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 +14,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'This method completes a reminder.'
-  g.long_desc %( This method completes a reminder. )
+  g.desc 'Marks a reminder as complete.'
+  g.long_desc %( Marks a reminder as complete. )
   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 +23,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'This method deletes a reminder.'
-  g.long_desc %( This method deletes a reminder. )
+  g.desc 'Deletes a reminder.'
+  g.long_desc %( 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 +32,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'This method returns information about a reminder.'
-  g.long_desc %( This method returns information about a reminder. )
+  g.desc 'Gets information about a reminder.'
+  g.long_desc %( Gets 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 +41,8 @@ command 'reminders' do |g|
     end
   end
 
-  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.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.command 'list' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reminders_list(options))

data/bin/commands/rtm.rb

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Rtm methods.'
 command 'rtm' do |g|
-  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.desc 'Starts a Real Time Messaging session.'
+  g.long_desc %( Starts a Real Time Messaging session. )
   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 +13,8 @@ command 'rtm' do |g|
     end
   end
 
-  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.desc 'Starts a Real Time Messaging session.'
+  g.long_desc %( Starts a Real Time Messaging session. )
   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,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Search methods.'
 command 'search' do |g|
-  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.desc 'Searches for messages and files matching a query.'
+  g.long_desc %( Searches for messages and files matching a query. )
   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 +15,8 @@ command 'search' do |g|
     end
   end
 
-  g.desc 'This method returns files matching a search query.'
-  g.long_desc %( This method returns files matching a search query. )
+  g.desc 'Searches for files matching a query.'
+  g.long_desc %( Searches for files matching a 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 +27,8 @@ command 'search' do |g|
     end
   end
 
-  g.desc 'This method returns messages matching a search query.'
-  g.long_desc %( This method returns messages matching a search query. )
+  g.desc 'Searches for messages matching a query.'
+  g.long_desc %( Searches for messages matching a 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

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Stars methods.'
 command 'stars' do |g|
-  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.desc 'Adds a star to an item.'
+  g.long_desc %( Adds a star to an item. )
   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 +15,8 @@ command 'stars' do |g|
     end
   end
 
-  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.desc 'Lists stars for a user.'
+  g.long_desc %( Lists stars for 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 '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 +25,8 @@ command 'stars' do |g|
     end
   end
 
-  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.desc 'Removes a star from an item.'
+  g.long_desc %( Removes a star from an item. )
   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

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Team methods.'
 command 'team' do |g|
-  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.desc 'Gets the access logs for the current team.'
+  g.long_desc %( Gets the access logs for the current team. )
   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 +12,8 @@ command 'team' do |g|
     end
   end
 
-  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.desc 'Gets billable users information for the current team.'
+  g.long_desc %( Gets billable users information for the current team. )
   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 +21,17 @@ command 'team' do |g|
     end
   end
 
-  g.desc 'This method provides information about your team.'
-  g.long_desc %( This method provides information about your team. )
+  g.desc 'Gets information about the current team.'
+  g.long_desc %( Gets information about the current team. )
   g.command 'info' do |c|
+    c.flag 'team', desc: 'Team to get info on, if omitted, will return information about the current team. Will only return team that the authenticated token is allowed to see through external shared channels.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.team_info(options))
     end
   end
 
-  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.desc 'Gets the integration logs for the current team.'
+  g.long_desc %( Gets the integration logs for the current team. )
   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

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'TeamProfile methods.'
 command 'team_profile' do |g|
-  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.desc "Retrieve a team's profile."
+  g.long_desc %( Retrieve a team's profile. )
   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,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Usergroups methods.'
 command 'usergroups' do |g|
-  g.desc 'This method is used to create a User Group.'
-  g.long_desc %( This method is used to create a User Group. )
+  g.desc 'Create a User Group'
+  g.long_desc %( 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 +16,8 @@ command 'usergroups' do |g|
     end
   end
 
-  g.desc 'This method disables an existing User Group.'
-  g.long_desc %( This method disables an existing User Group. )
+  g.desc 'Disable an existing User Group'
+  g.long_desc %( Disable 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 +26,8 @@ command 'usergroups' do |g|
     end
   end
 
-  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.desc 'Enable a User Group'
+  g.long_desc %( Enable a User Group )
   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 +36,8 @@ command 'usergroups' do |g|
     end
   end
 
-  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.desc 'List all User Groups for a team'
+  g.long_desc %( List all User Groups for a team )
   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 +47,8 @@ command 'usergroups' do |g|
     end
   end
 
-  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.desc 'Update an existing User Group'
+  g.long_desc %( Update 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.'