slack-ruby-client 0.14.1 → 0.14.2

data/bin/commands/chat_scheduledMessages.rb

@@ -0,0 +1,17 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'ChatScheduledmessages methods.'
+command 'chat_scheduledMessages' do |g|
+  g.desc 'This method returns a list of pending scheduled messages.'
+  g.long_desc %( This method returns a list of pending scheduled messages. )
+  g.command 'list' do |c|
+    c.flag 'channel', desc: 'The channel of the scheduled messages.'
+    c.flag 'cursor', desc: 'For pagination purposes, this is the cursor value returned from a previous call to chat.scheduledmessages.list indicating where you want to start this call from.'
+    c.flag 'latest', desc: 'A UNIX timestamp of the latest value in the time range.'
+    c.flag 'limit', desc: 'Maximum number of original entries to return.'
+    c.flag 'oldest', desc: 'A UNIX timestamp of the oldest value in the time range.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.chat_scheduledMessages_list(options))
+    end
+  end
+end

data/bin/commands/conversations.rb

@@ -1,9 +1,9 @@
 # This file was auto-generated by lib/tasks/web.rake
 
-desc "Interface with all kinds of conversations the same way, whether they're public or private channels, direct messages, or otherwise."
+desc 'Conversations methods.'
 command 'conversations' do |g|
-  g.desc 'Archives a conversation.'
-  g.long_desc %( Archives a conversation. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'archive' do |c|
     c.flag 'channel', desc: 'ID of conversation to archive.'
     c.action do |_global_options, options, _args|
@@ -11,8 +11,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Closes a direct message or multi-person direct message.'
-  g.long_desc %( Closes a direct message or multi-person direct message. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'close' do |c|
     c.flag 'channel', desc: 'Conversation to close.'
     c.action do |_global_options, options, _args|
@@ -20,8 +20,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Initiates a public or private channel-based conversation'
-  g.long_desc %( Initiates a public or private channel-based conversation )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'create' do |c|
     c.flag 'name', desc: 'Name of the public or private channel to create.'
     c.flag 'is_private', desc: 'Create a private channel instead of a public one.'
@@ -31,8 +31,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "Fetches a conversation's history of messages and events."
-  g.long_desc %( Fetches a conversation's history of messages and events. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'history' do |c|
     c.flag 'channel', desc: 'Conversation ID to fetch history for.'
     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."
@@ -45,8 +45,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Retrieve information about a conversation.'
-  g.long_desc %( Retrieve information about a conversation. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'info' do |c|
     c.flag 'channel', desc: 'Conversation ID to learn more about.'
     c.flag 'include_locale', desc: 'Set this to true to receive the locale for this conversation. Defaults to false.'
@@ -56,8 +56,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Invites users to a channel.'
-  g.long_desc %( Invites users to a channel. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'invite' do |c|
     c.flag 'channel', desc: 'The ID of the public or private channel to invite user(s) to.'
     c.flag 'users', desc: 'A comma separated list of user IDs. Up to 30 users may be listed.'
@@ -66,8 +66,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Joins an existing conversation.'
-  g.long_desc %( Joins an existing conversation. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'join' do |c|
     c.flag 'channel', desc: 'ID of conversation to join.'
     c.action do |_global_options, options, _args|
@@ -75,8 +75,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Removes a user from a conversation.'
-  g.long_desc %( Removes a user from a conversation. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'kick' do |c|
     c.flag 'channel', desc: 'ID of conversation to remove user from.'
     c.flag 'user', desc: 'User ID to be removed.'
@@ -85,8 +85,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Leaves a conversation.'
-  g.long_desc %( Leaves a conversation. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'leave' do |c|
     c.flag 'channel', desc: 'Conversation to leave.'
     c.action do |_global_options, options, _args|
@@ -94,8 +94,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Lists all channels in a Slack team.'
-  g.long_desc %( Lists all channels in a Slack team. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   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 'exclude_archived', desc: 'Set to true to exclude archived channels from the list.'
@@ -106,8 +106,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Retrieve members of a conversation.'
-  g.long_desc %( Retrieve members of a conversation. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'members' do |c|
     c.flag 'channel', desc: 'ID of the conversation to retrieve members for.'
     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."
@@ -117,8 +117,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Opens or resumes a direct message or multi-person direct message.'
-  g.long_desc %( Opens or resumes a direct message or multi-person direct message. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'open' do |c|
     c.flag 'channel', desc: "Resume a conversation by supplying an im or mpim's ID. Or provide the users field instead."
     c.flag 'return_im', desc: 'Boolean, indicates you want the full IM channel definition in the response.'
@@ -128,8 +128,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Renames a conversation.'
-  g.long_desc %( Renames a conversation. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'rename' do |c|
     c.flag 'channel', desc: 'ID of conversation to rename.'
     c.flag 'name', desc: 'New name for conversation.'
@@ -138,8 +138,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Retrieve a thread of messages posted to a conversation'
-  g.long_desc %( Retrieve a thread of messages posted to a conversation )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'replies' do |c|
     c.flag 'channel', desc: 'Conversation ID to fetch thread from.'
     c.flag 'ts', desc: "Unique identifier of a thread's parent message."
@@ -153,8 +153,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Sets the purpose for a conversation.'
-  g.long_desc %( Sets the purpose for a conversation. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'setPurpose' do |c|
     c.flag 'channel', desc: 'Conversation to set the purpose of.'
     c.flag 'purpose', desc: 'A new, specialer purpose.'
@@ -163,8 +163,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Sets the topic for a conversation.'
-  g.long_desc %( Sets the topic for a conversation. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'setTopic' do |c|
     c.flag 'channel', desc: 'Conversation to set the topic of.'
     c.flag 'topic', desc: 'The new topic string. Does not support formatting or linkification.'
@@ -173,8 +173,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc 'Reverses conversation archival.'
-  g.long_desc %( Reverses conversation archival. )
+  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
+  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
   g.command 'unarchive' do |c|
     c.flag 'channel', desc: 'ID of conversation to unarchive.'
     c.action do |_global_options, options, _args|

data/bin/commands/dialog.rb

@@ -2,8 +2,8 @@
 
 desc 'Dialog methods.'
 command 'dialog' do |g|
-  g.desc 'Open a dialog with a user'
-  g.long_desc %( Open a dialog with a user )
+  g.desc 'Open a dialog with a user by exchanging a trigger_id received from another interaction. See the dialogs documentation to learn how to obtain triggers define form elements.'
+  g.long_desc %( Open a dialog with a user by exchanging a trigger_id received from another interaction. See the dialogs documentation to learn how to obtain triggers define form elements. )
   g.command 'open' do |c|
     c.flag 'dialog', desc: 'The dialog definition. This must be a JSON-encoded string.'
     c.flag 'trigger_id', desc: 'Exchange a trigger to post to the user.'

data/bin/commands/dnd.rb

@@ -1,9 +1,9 @@
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'Adjust and view Do Not Disturb settings for team members.'
+desc 'Dnd methods.'
 command 'dnd' do |g|
-  g.desc "Ends the current user's Do Not Disturb session immediately."
-  g.long_desc %( Ends the current user's Do Not Disturb session immediately. )
+  g.desc "Ends the user's currently scheduled Do Not Disturb session immediately."
+  g.long_desc %( Ends the user's currently scheduled Do Not Disturb session immediately. )
   g.command 'endDnd' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.dnd_endDnd(options))
@@ -18,8 +18,8 @@ command 'dnd' do |g|
     end
   end
 
-  g.desc "Retrieves a user's current Do Not Disturb status."
-  g.long_desc %( Retrieves a user's current Do Not Disturb status. )
+  g.desc "Provides information about a user's current Do Not Disturb settings."
+  g.long_desc %( Provides information about a user's current Do Not Disturb settings. )
   g.command 'info' do |c|
     c.flag 'user', desc: 'User to fetch status for (defaults to current user).'
     c.action do |_global_options, options, _args|
@@ -27,8 +27,8 @@ command 'dnd' do |g|
     end
   end
 
-  g.desc 'Turns on Do Not Disturb mode for the current user, or changes its duration.'
-  g.long_desc %( Turns on Do Not Disturb mode for the current user, or changes its duration. )
+  g.desc "Adjusts the snooze duration for a user's Do Not Disturb settings. If a snooze session is not already active for the user, invoking this method will begin one for the specified duration."
+  g.long_desc %( Adjusts the snooze duration for a user's Do Not Disturb settings. If a snooze session is not already active for the user, invoking this method will begin one for the specified duration. )
   g.command 'setSnooze' do |c|
     c.flag 'num_minutes', desc: 'Number of minutes, from now, to snooze until.'
     c.action do |_global_options, options, _args|
@@ -36,8 +36,8 @@ command 'dnd' do |g|
     end
   end
 
-  g.desc 'Retrieves the Do Not Disturb status for users on a team.'
-  g.long_desc %( Retrieves the Do Not Disturb status for users on a team. )
+  g.desc 'Provides information about the current Do Not Disturb settings for a list of users in a Slack team.'
+  g.long_desc %( Provides information about the current Do Not Disturb settings for a list of users in a Slack team. )
   g.command 'teamInfo' do |c|
     c.flag 'users', desc: 'Comma-separated list of users to fetch Do Not Disturb status for.'
     c.action do |_global_options, options, _args|

data/bin/commands/emoji.rb

@@ -2,8 +2,8 @@
 
 desc 'Emoji methods.'
 command 'emoji' do |g|
-  g.desc 'Lists custom emoji for a team.'
-  g.long_desc %( Lists custom emoji for a team. )
+  g.desc 'This method lists the custom emoji for a team.'
+  g.long_desc %( This method lists the custom emoji for a team. )
   g.command 'list' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.emoji_list(options))

data/bin/commands/files.rb

@@ -1,9 +1,9 @@
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'Get info on files uploaded to Slack, upload new files to Slack.'
+desc 'Files methods.'
 command 'files' do |g|
-  g.desc 'Deletes a file.'
-  g.long_desc %( Deletes a file. )
+  g.desc "A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments."
+  g.long_desc %( A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments. )
   g.command 'delete' do |c|
     c.flag 'file', desc: 'ID of file to delete.'
     c.action do |_global_options, options, _args|
@@ -22,8 +22,8 @@ command 'files' do |g|
     end
   end
 
-  g.desc 'Gets information about a team file.'
-  g.long_desc %( Gets information about a team file. )
+  g.desc "A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments."
+  g.long_desc %( A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments. )
   g.command 'info' do |c|
     c.flag 'file', desc: 'Specify a file by providing its ID.'
     c.flag 'cursor', desc: "Parameter for pagination. File comments are paginated for a single file. 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 of comments. See pagination for more details."
@@ -33,32 +33,21 @@ command 'files' do |g|
     end
   end
 
-  g.desc 'Lists & filters team files.'
-  g.long_desc %( Lists & filters team files. )
+  g.desc "A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments."
+  g.long_desc %( A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments. )
   g.command 'list' do |c|
     c.flag 'channel', desc: 'Filter files appearing in a specific channel, indicated by its ID.'
     c.flag 'ts_from', desc: 'Filter files created after this timestamp (inclusive).'
     c.flag 'ts_to', desc: 'Filter files created before this timestamp (inclusive).'
-    c.flag 'types', desc: 'Filter files by type:
-* `all` - All files
-* `spaces` - Posts
-* `snippets` - Snippets
-* `images` - Image files
-* `gdocs` - Google docs
-* `zips` - Zip files
-* `pdfs` - PDF files
-
-You can pass multiple values in the types argument, like `types=spaces,snippets`.The default value is `all`, which does not filter the list.
-
-.'
+    c.flag 'types', desc: 'Filter files by type (see below). You can pass multiple values in the types argument, like types=spaces,snippets.The default value is all, which does not filter the list.'
     c.flag 'user', desc: 'Filter files created by a single user.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.files_list(options))
     end
   end
 
-  g.desc 'Revokes public/external sharing access for a file'
-  g.long_desc %( Revokes public/external sharing access for a file )
+  g.desc "A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments."
+  g.long_desc %( A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments. )
   g.command 'revokePublicURL' do |c|
     c.flag 'file', desc: 'File to revoke.'
     c.action do |_global_options, options, _args|
@@ -76,8 +65,8 @@ You can pass multiple values in the types argument, like `types=spaces,snippets`
     end
   end
 
-  g.desc 'Enables a file for public/external sharing.'
-  g.long_desc %( Enables a file for public/external sharing. )
+  g.desc "A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments."
+  g.long_desc %( A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments. )
   g.command 'sharedPublicURL' do |c|
     c.flag 'file', desc: 'File to share.'
     c.action do |_global_options, options, _args|
@@ -85,8 +74,8 @@ You can pass multiple values in the types argument, like `types=spaces,snippets`
     end
   end
 
-  g.desc 'Uploads or creates a file.'
-  g.long_desc %( Uploads or creates a file. )
+  g.desc "A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments."
+  g.long_desc %( A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments. )
   g.command 'upload' do |c|
     c.flag 'channels', desc: 'Comma-separated list of channel names or IDs where the file will be shared.'
     c.flag 'content', desc: 'File contents via a POST variable. If omitting this parameter, you must provide a file.'

data/bin/commands/files_comments.rb

@@ -2,18 +2,8 @@
 
 desc 'FilesComments methods.'
 command 'files_comments' do |g|
-  g.desc 'Add a comment to an existing file.'
-  g.long_desc %( Add a comment to an existing file. )
-  g.command 'add' do |c|
-    c.flag 'comment', desc: 'Text of the comment to add.'
-    c.flag 'file', desc: 'File to add a comment to.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.files_comments_add(options))
-    end
-  end
-
-  g.desc 'Deletes an existing comment on a file.'
-  g.long_desc %( Deletes an existing comment on a file. )
+  g.desc "A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments."
+  g.long_desc %( A new file commenting experience arrived on July 23, 2018. Learn more about what's new and the migration path for apps already working with files and file comments. )
   g.command 'delete' do |c|
     c.flag 'file', desc: 'File to delete a comment from.'
     c.flag 'id', desc: 'The comment to delete.'
@@ -21,15 +11,4 @@ command 'files_comments' do |g|
       puts JSON.dump($client.files_comments_delete(options))
     end
   end
-
-  g.desc 'Edit an existing file comment.'
-  g.long_desc %( Edit an existing file comment. )
-  g.command 'edit' do |c|
-    c.flag 'comment', desc: 'Text of the comment to edit.'
-    c.flag 'file', desc: 'File containing the comment to edit.'
-    c.flag 'id', desc: 'The comment to edit.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.files_comments_edit(options))
-    end
-  end
 end

data/bin/commands/groups.rb

@@ -1,9 +1,9 @@
 # This file was auto-generated by lib/tasks/web.rake
 
-desc "Get info on your team's private channels."
+desc 'Groups methods.'
 command 'groups' do |g|
-  g.desc 'Archives a private channel.'
-  g.long_desc %( Archives a private channel. )
+  g.desc 'This method archives a private channel.'
+  g.long_desc %( This method archives a private channel. )
   g.command 'archive' do |c|
     c.flag 'channel', desc: 'Private channel to archive.'
     c.action do |_global_options, options, _args|
@@ -11,8 +11,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Creates a private channel.'
-  g.long_desc %( Creates a private channel. )
+  g.desc 'This method creates a private channel.'
+  g.long_desc %( This method creates a private channel. )
   g.command 'create' do |c|
     c.flag 'name', desc: 'Name of private channel to create.'
     c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
@@ -21,8 +21,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Clones and archives a private channel.'
-  g.long_desc %( Clones and archives a private channel. )
+  g.desc 'This method takes an existing private channel and performs the following steps:'
+  g.long_desc %( This method takes an existing private channel and performs the following steps: )
   g.command 'createChild' do |c|
     c.flag 'channel', desc: 'Private channel to clone and archive.'
     c.action do |_global_options, options, _args|
@@ -30,8 +30,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Fetches history of messages and events from a private channel.'
-  g.long_desc %( Fetches history of messages and events from a private channel. )
+  g.desc 'This method returns a portion of messages/events from the specified private channel.'
+  g.long_desc %( This method returns a portion of messages/events from the specified private channel. To read the entire history for a private 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: 'Private channel to fetch history for.'
     c.flag 'inclusive', desc: 'Include messages with latest or oldest timestamp in results.'
@@ -52,8 +52,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Gets information about a private channel.'
-  g.long_desc %( Gets information about a private channel. )
+  g.desc "Don't use this method. Use conversations.info instead."
+  g.long_desc %( Don't use this method. Use conversations.info instead. )
   g.command 'info' do |c|
     c.flag 'channel', desc: 'Private channel to get info on.'
     c.flag 'include_locale', desc: 'Set this to true to receive the locale for this group. Defaults to false.'
@@ -62,8 +62,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Invites a user to a private channel.'
-  g.long_desc %( Invites a user to a private channel. )
+  g.desc 'This method is used to invite a user to a private channel. The calling user must be a member of the private channel.'
+  g.long_desc %( This method is used to invite a user to a private channel. The calling user must be a member of the private channel. )
   g.command 'invite' do |c|
     c.flag 'channel', desc: 'Private channel to invite user to.'
     c.flag 'user', desc: 'User to invite.'
@@ -72,8 +72,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Removes a user from a private channel.'
-  g.long_desc %( Removes a user from a private channel. )
+  g.desc 'This method allows a user to remove another member from a private channel.'
+  g.long_desc %( This method allows a user to remove another member from a private channel. )
   g.command 'kick' do |c|
     c.flag 'channel', desc: 'Private channel to remove user from.'
     c.flag 'user', desc: 'User to remove from private channel.'
@@ -82,8 +82,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Leaves a private channel.'
-  g.long_desc %( Leaves a private channel. )
+  g.desc 'This method is used to leave a private channel.'
+  g.long_desc %( This method is used to leave a private channel. )
   g.command 'leave' do |c|
     c.flag 'channel', desc: 'Private channel to leave.'
     c.action do |_global_options, options, _args|
@@ -91,8 +91,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Lists private channels that the calling user has access to.'
-  g.long_desc %( Lists private channels that the calling user has access to. )
+  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 'exclude_archived', desc: "Don't return archived private channels."
@@ -103,8 +103,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Sets the read cursor in a private channel.'
-  g.long_desc %( Sets the read cursor in a private channel. )
+  g.desc 'This method moves the read cursor in a private channel.'
+  g.long_desc %( This method moves the read cursor in a private channel. )
   g.command 'mark' do |c|
     c.flag 'channel', desc: 'Private channel to set reading cursor in.'
     c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
@@ -113,8 +113,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Opens a private channel.'
-  g.long_desc %( Opens a private channel. )
+  g.desc 'This method opens a private channel.'
+  g.long_desc %( This method opens a private channel. )
   g.command 'open' do |c|
     c.flag 'channel', desc: 'Private channel to open.'
     c.action do |_global_options, options, _args|
@@ -122,8 +122,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Renames a private channel.'
-  g.long_desc %( Renames a private channel. )
+  g.desc 'This method renames a private channel.'
+  g.long_desc %( This method renames a private channel. )
   g.command 'rename' do |c|
     c.flag 'channel', desc: 'Private channel to rename.'
     c.flag 'name', desc: 'New name for private channel.'
@@ -133,8 +133,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Retrieve a thread of messages posted to a private channel'
-  g.long_desc %( Retrieve a thread of messages posted to a private channel )
+  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: 'Private channel to fetch thread from.'
     c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."
@@ -143,8 +143,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Sets the purpose for a private channel.'
-  g.long_desc %( Sets the purpose for a private channel. )
+  g.desc 'This method is used to change the purpose of a private channel. The calling user must be a member of the private channel.'
+  g.long_desc %( This method is used to change the purpose of a private channel. The calling user must be a member of the private channel. )
   g.command 'setPurpose' do |c|
     c.flag 'channel', desc: 'Private channel to set the purpose of.'
     c.flag 'purpose', desc: 'The new purpose.'
@@ -153,8 +153,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Sets the topic for a private channel.'
-  g.long_desc %( Sets the topic for a private channel. )
+  g.desc 'This method is used to change the topic of a private channel. The calling user must be a member of the private channel.'
+  g.long_desc %( This method is used to change the topic of a private channel. The calling user must be a member of the private channel. )
   g.command 'setTopic' do |c|
     c.flag 'channel', desc: 'Private channel to set the topic of.'
     c.flag 'topic', desc: 'The new topic.'
@@ -163,8 +163,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'Unarchives a private channel.'
-  g.long_desc %( Unarchives a private channel. )
+  g.desc 'This method unarchives a private channel.'
+  g.long_desc %( This method unarchives a private channel. )
   g.command 'unarchive' do |c|
     c.flag 'channel', desc: 'Private channel to unarchive.'
     c.action do |_global_options, options, _args|