{"action":"created","comment":{"url":"https://api.github.com/repos/mattermost/docs/pulls/comments/90169937","pull_request_review_id":10691279,"id":90169937,"diff_hunk":"@@ -26,4 +26,70 @@ The following instructions migrate Mattermost from one server to another by back\n Migrating from Slack\n ====================\n \n-You can import channels and users from Slack into Mattermost from Team Settings > Import. Please review our documentation on `Slack Import <https://docs.mattermost.com/help/settings/team-settings.html#import-from-slack-beta>`_ for more details.\n+.. note:: As a proprietary SaaS service, Slack is able to change its export format quickly and without notice. If you encounter issues not mentioned in the documentation below, please alert the product team by `filing an issue <https://github.com/mattermost/platform/issues>`_.\n+\n+The Slack Import feature in Mattermost is in \"Beta\" and focused on supporting migration of teams of less than 100 registered users.\n+\n+This feature can be accessed through the `Mattermost Web App </administration/migrating.html#migrating-from-slack-using-the-mattermost-web-app>`_ or using the `CLI </administration/migrating.html#migrating-from-slack-using-the-mattermost-cli>`_.\n+\n+.. warning:: **It is highly recommended that you test Slack import before applying it to an instance intended for production.**\n+\n+   If you use Docker, you can spin up a test instance in one line (``docker run --name mattermost-dev -d --publish 8065:80 mattermost/platform``). If you don't use Docker, there are `step-by-step instructions <http://docs.mattermost.com/install/docker-local-machine.html>`_ to install Mattermost in preview mode in less than 5 minutes.\n+\n+Supported Features\n+++++++++++++++++++\n+\n+The following key features are supported out of the box when importing from Slack:\n+\n+* User accounts with an email address set.\n+\n+* Public channels and the text messages posted in them by users.\n+\n+* Channel topic and purpose.\n+\n+* Automatically adding imported users to their channels.\n+\n+Messages with file attachments are imported as a message containing a link to Slack's servers by default. The file attachments themselves can be imported to Mattermost by using the `Slack Advanced Exporter <https://github.com/grundleborg/slack-advanced-exporter>`_ tool to add them to your archive before importing it.\n+\n+Bot and Integration messages are imported by default, but if you would like them to display with the appropriate username when imported, you should ensure that `Enable Integrations to Override Usernames </administration/config-settings.html#enable-integrations-to-override-usernames>`_ is set **before** doing the import.","path":"source/administration/migrating.rst","position":30,"original_position":30,"commit_id":"58e5a247a5ffbb48a713c6212e2655af2a09fb0b","original_commit_id":"58e5a247a5ffbb48a713c6212e2655af2a09fb0b","user":{"login":"jasonblais","id":13119842,"avatar_url":"https://avatars.githubusercontent.com/u/13119842?v=3","gravatar_id":"","url":"https://api.github.com/users/jasonblais","html_url":"https://github.com/jasonblais","followers_url":"https://api.github.com/users/jasonblais/followers","following_url":"https://api.github.com/users/jasonblais/following{/other_user}","gists_url":"https://api.github.com/users/jasonblais/gists{/gist_id}","starred_url":"https://api.github.com/users/jasonblais/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jasonblais/subscriptions","organizations_url":"https://api.github.com/users/jasonblais/orgs","repos_url":"https://api.github.com/users/jasonblais/repos","events_url":"https://api.github.com/users/jasonblais/events{/privacy}","received_events_url":"https://api.github.com/users/jasonblais/received_events","type":"User","site_admin":false},"body":"Same thing with the link, not sure if `</administration...>` is enough? (might be, just don't know)\r\n\r\nMaybe add `you should ensure that 'Enable Integrations .... is set in **System Console > Integrations > Custom Integrations** ....`","created_at":"2016-11-30T05:14:34Z","updated_at":"2016-11-30T05:19:34Z","html_url":"https://github.com/mattermost/docs/pull/673#discussion_r90169937","pull_request_url":"https://api.github.com/repos/mattermost/docs/pulls/673","_links":{"self":{"href":"https://api.github.com/repos/mattermost/docs/pulls/comments/90169937"},"html":{"href":"https://github.com/mattermost/docs/pull/673#discussion_r90169937"},"pull_request":{"href":"https://api.github.com/repos/mattermost/docs/pulls/673"}}},"pull_request":{"url":"https://api.github.com/repos/mattermost/docs/pulls/673","id":94865354,"html_url":"https://github.com/mattermost/docs/pull/673","diff_url":"https://github.com/mattermost/docs/pull/673.diff","patch_url":"https://github.com/mattermost/docs/pull/673.patch","issue_url":"https://api.github.com/repos/mattermost/docs/issues/673","number":673,"state":"open","locked":false,"title":"Update the Slack import docs with latest features.","user":{"login":"grundleborg","id":1198059,"avatar_url":"https://avatars.githubusercontent.com/u/1198059?v=3","gravatar_id":"","url":"https://api.github.com/users/grundleborg","html_url":"https://github.com/grundleborg","followers_url":"https://api.github.com/users/grundleborg/followers","following_url":"https://api.github.com/users/grundleborg/following{/other_user}","gists_url":"https://api.github.com/users/grundleborg/gists{/gist_id}","starred_url":"https://api.github.com/users/grundleborg/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/grundleborg/subscriptions","organizations_url":"https://api.github.com/users/grundleborg/orgs","repos_url":"https://api.github.com/users/grundleborg/repos","events_url":"https://api.github.com/users/grundleborg/events{/privacy}","received_events_url":"https://api.github.com/users/grundleborg/received_events","type":"User","site_admin":false},"body":"This updates the Slack import docs, in particular to note the fact that\r\nBot messages, and file attachments can now be imported.\r\n\r\nPlease let me know what you think of this, as I'm sure there's room to improve the quality of expression and clarity of information.\r\n\r\nhttps://mattermost.atlassian.net/browse/PLT-4280","created_at":"2016-11-22T17:53:44Z","updated_at":"2016-11-30T05:19:34Z","closed_at":null,"merged_at":null,"merge_commit_sha":"d29aaea5b60323d46751e70e1e4d6484fe53ce25","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/mattermost/docs/pulls/673/commits","review_comments_url":"https://api.github.com/repos/mattermost/docs/pulls/673/comments","review_comment_url":"https://api.github.com/repos/mattermost/docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/mattermost/docs/issues/673/comments","statuses_url":"https://api.github.com/repos/mattermost/docs/statuses/58e5a247a5ffbb48a713c6212e2655af2a09fb0b","head":{"label":"grundleborg:PLT-4280","ref":"PLT-4280","sha":"58e5a247a5ffbb48a713c6212e2655af2a09fb0b","user":{"login":"grundleborg","id":1198059,"avatar_url":"https://avatars.githubusercontent.com/u/1198059?v=3","gravatar_id":"","url":"https://api.github.com/users/grundleborg","html_url":"https://github.com/grundleborg","followers_url":"https://api.github.com/users/grundleborg/followers","following_url":"https://api.github.com/users/grundleborg/following{/other_user}","gists_url":"https://api.github.com/users/grundleborg/gists{/gist_id}","starred_url":"https://api.github.com/users/grundleborg/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/grundleborg/subscriptions","organizations_url":"https://api.github.com/users/grundleborg/orgs","repos_url":"https://api.github.com/users/grundleborg/repos","events_url":"https://api.github.com/users/grundleborg/events{/privacy}","received_events_url":"https://api.github.com/users/grundleborg/received_events","type":"User","site_admin":false},"repo":{"id":71492245,"name":"docs","full_name":"grundleborg/docs","owner":{"login":"grundleborg","id":1198059,"avatar_url":"https://avatars.githubusercontent.com/u/1198059?v=3","gravatar_id":"","url":"https://api.github.com/users/grundleborg","html_url":"https://github.com/grundleborg","followers_url":"https://api.github.com/users/grundleborg/followers","following_url":"https://api.github.com/users/grundleborg/following{/other_user}","gists_url":"https://api.github.com/users/grundleborg/gists{/gist_id}","starred_url":"https://api.github.com/users/grundleborg/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/grundleborg/subscriptions","organizations_url":"https://api.github.com/users/grundleborg/orgs","repos_url":"https://api.github.com/users/grundleborg/repos","events_url":"https://api.github.com/users/grundleborg/events{/privacy}","received_events_url":"https://api.github.com/users/grundleborg/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/grundleborg/docs","description":null,"fork":true,"url":"https://api.github.com/repos/grundleborg/docs","forks_url":"https://api.github.com/repos/grundleborg/docs/forks","keys_url":"https://api.github.com/repos/grundleborg/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/grundleborg/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/grundleborg/docs/teams","hooks_url":"https://api.github.com/repos/grundleborg/docs/hooks","issue_events_url":"https://api.github.com/repos/grundleborg/docs/issues/events{/number}","events_url":"https://api.github.com/repos/grundleborg/docs/events","assignees_url":"https://api.github.com/repos/grundleborg/docs/assignees{/user}","branches_url":"https://api.github.com/repos/grundleborg/docs/branches{/branch}","tags_url":"https://api.github.com/repos/grundleborg/docs/tags","blobs_url":"https://api.github.com/repos/grundleborg/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/grundleborg/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/grundleborg/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/grundleborg/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/grundleborg/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/grundleborg/docs/languages","stargazers_url":"https://api.github.com/repos/grundleborg/docs/stargazers","contributors_url":"https://api.github.com/repos/grundleborg/docs/contributors","subscribers_url":"https://api.github.com/repos/grundleborg/docs/subscribers","subscription_url":"https://api.github.com/repos/grundleborg/docs/subscription","commits_url":"https://api.github.com/repos/grundleborg/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/grundleborg/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/grundleborg/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/grundleborg/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/grundleborg/docs/contents/{+path}","compare_url":"https://api.github.com/repos/grundleborg/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/grundleborg/docs/merges","archive_url":"https://api.github.com/repos/grundleborg/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/grundleborg/docs/downloads","issues_url":"https://api.github.com/repos/grundleborg/docs/issues{/number}","pulls_url":"https://api.github.com/repos/grundleborg/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/grundleborg/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/grundleborg/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/grundleborg/docs/labels{/name}","releases_url":"https://api.github.com/repos/grundleborg/docs/releases{/id}","deployments_url":"https://api.github.com/repos/grundleborg/docs/deployments","created_at":"2016-10-20T18:29:00Z","updated_at":"2016-10-20T18:29:03Z","pushed_at":"2016-11-28T08:34:56Z","git_url":"git://github.com/grundleborg/docs.git","ssh_url":"git@github.com:grundleborg/docs.git","clone_url":"https://github.com/grundleborg/docs.git","svn_url":"https://github.com/grundleborg/docs","homepage":null,"size":22157,"stargazers_count":0,"watchers_count":0,"language":"HTML","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"mattermost:master","ref":"master","sha":"d672997572af9ed84fe44712888841347ae4ca22","user":{"login":"mattermost","id":9828093,"avatar_url":"https://avatars.githubusercontent.com/u/9828093?v=3","gravatar_id":"","url":"https://api.github.com/users/mattermost","html_url":"https://github.com/mattermost","followers_url":"https://api.github.com/users/mattermost/followers","following_url":"https://api.github.com/users/mattermost/following{/other_user}","gists_url":"https://api.github.com/users/mattermost/gists{/gist_id}","starred_url":"https://api.github.com/users/mattermost/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mattermost/subscriptions","organizations_url":"https://api.github.com/users/mattermost/orgs","repos_url":"https://api.github.com/users/mattermost/repos","events_url":"https://api.github.com/users/mattermost/events{/privacy}","received_events_url":"https://api.github.com/users/mattermost/received_events","type":"Organization","site_admin":false},"repo":{"id":46522468,"name":"docs","full_name":"mattermost/docs","owner":{"login":"mattermost","id":9828093,"avatar_url":"https://avatars.githubusercontent.com/u/9828093?v=3","gravatar_id":"","url":"https://api.github.com/users/mattermost","html_url":"https://github.com/mattermost","followers_url":"https://api.github.com/users/mattermost/followers","following_url":"https://api.github.com/users/mattermost/following{/other_user}","gists_url":"https://api.github.com/users/mattermost/gists{/gist_id}","starred_url":"https://api.github.com/users/mattermost/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mattermost/subscriptions","organizations_url":"https://api.github.com/users/mattermost/orgs","repos_url":"https://api.github.com/users/mattermost/repos","events_url":"https://api.github.com/users/mattermost/events{/privacy}","received_events_url":"https://api.github.com/users/mattermost/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/mattermost/docs","description":null,"fork":false,"url":"https://api.github.com/repos/mattermost/docs","forks_url":"https://api.github.com/repos/mattermost/docs/forks","keys_url":"https://api.github.com/repos/mattermost/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mattermost/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mattermost/docs/teams","hooks_url":"https://api.github.com/repos/mattermost/docs/hooks","issue_events_url":"https://api.github.com/repos/mattermost/docs/issues/events{/number}","events_url":"https://api.github.com/repos/mattermost/docs/events","assignees_url":"https://api.github.com/repos/mattermost/docs/assignees{/user}","branches_url":"https://api.github.com/repos/mattermost/docs/branches{/branch}","tags_url":"https://api.github.com/repos/mattermost/docs/tags","blobs_url":"https://api.github.com/repos/mattermost/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mattermost/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mattermost/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/mattermost/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mattermost/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/mattermost/docs/languages","stargazers_url":"https://api.github.com/repos/mattermost/docs/stargazers","contributors_url":"https://api.github.com/repos/mattermost/docs/contributors","subscribers_url":"https://api.github.com/repos/mattermost/docs/subscribers","subscription_url":"https://api.github.com/repos/mattermost/docs/subscription","commits_url":"https://api.github.com/repos/mattermost/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/mattermost/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/mattermost/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/mattermost/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/mattermost/docs/contents/{+path}","compare_url":"https://api.github.com/repos/mattermost/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mattermost/docs/merges","archive_url":"https://api.github.com/repos/mattermost/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mattermost/docs/downloads","issues_url":"https://api.github.com/repos/mattermost/docs/issues{/number}","pulls_url":"https://api.github.com/repos/mattermost/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/mattermost/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/mattermost/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mattermost/docs/labels{/name}","releases_url":"https://api.github.com/repos/mattermost/docs/releases{/id}","deployments_url":"https://api.github.com/repos/mattermost/docs/deployments","created_at":"2015-11-19T21:48:32Z","updated_at":"2016-11-26T22:29:07Z","pushed_at":"2016-11-29T21:59:05Z","git_url":"git://github.com/mattermost/docs.git","ssh_url":"git@github.com:mattermost/docs.git","clone_url":"https://github.com/mattermost/docs.git","svn_url":"https://github.com/mattermost/docs","homepage":null,"size":22901,"stargazers_count":27,"watchers_count":27,"language":"HTML","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":86,"mirror_url":null,"open_issues_count":26,"forks":86,"open_issues":26,"watchers":27,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/mattermost/docs/pulls/673"},"html":{"href":"https://github.com/mattermost/docs/pull/673"},"issue":{"href":"https://api.github.com/repos/mattermost/docs/issues/673"},"comments":{"href":"https://api.github.com/repos/mattermost/docs/issues/673/comments"},"review_comments":{"href":"https://api.github.com/repos/mattermost/docs/pulls/673/comments"},"review_comment":{"href":"https://api.github.com/repos/mattermost/docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/mattermost/docs/pulls/673/commits"},"statuses":{"href":"https://api.github.com/repos/mattermost/docs/statuses/58e5a247a5ffbb48a713c6212e2655af2a09fb0b"}}}}
{"actor":{"display_login":"jasonblais"}}