Merge pull request #2253 from metabase/metabot_documentation

Metabot documentation

docs/users-guide/10-metabot.md

+# Getting answers in Slack with Metabot
+
+You can already send data to Slack on  a set schedule via [Pulses](http://www.metabase.com/docs/latest/users-guide/07-pulses) but what about when you need an answer right now? Say hello to Metabot.
+
+Metabot helps add context to conversations you’re having in Slack by letting you insert results from Metabase.
+
+## Connecting to Slack.
+To use Metabot with Slack you’ll first need to connect Metabase to your Slack with an API token.
+
+See [Setting up Slack](http://www.metabase.com/docs/v0.15.1/administration-guide/07-setting-up-slack) for more information.
+
+
+## What can Metabot do?
+
+Metabot can show individual questions and also lists of questions that have already been asked in Metabase.
+
+If you ever need help remembering what Metabot can do, just type ```metabot help``` in Slack.
+
+![Metabot help](images/metabot/MetabotHelp.png)
+
+## Showing questions
+
+To see a question from Metabase in Slack type
+```metabot show "<question-name>"``` where question name is the title of one of saved questions. If you have several similarly named questions Metabot will ask you to differentiate between the two by typing the number next to the name.
+
+![Metabot similar](images/metabot/MetabotSimilarItems.png)
+
+That number is the ID number of the question in Metabase and if you find yourself using the same question over and over again you can save a bit of time by typing “metabot show 19.”
+
+![Metabot show](images/metabot/MetabotShow.png)
+
+## Listing questions
+If you don’t have a sense of which questions you want to view in  Slack, you can type ```metabot list``` to get a list of recent questions from your Metabase.
+
+![Metabot show](images/metabot/MetabotList.png)
+
+
+## To review
+
+- [Connect to Slack](http://www.metabase.com/docs/latest/users-guide/07-pulses) to start using Metabot.
+- Show data from Metabase in Slack using ```metabot show <question-id>```
+- Search for questions by typing ```metabot show <search-term>```
+- Get a list of questions by typing ```metabot list```
+- ```metabot help``` lets you see everything Metabot can do if you forget or need more information

docs/users-guide/start.md

@@ -20,4 +20,6 @@
 
 > [Visualizing multiple series](09-data-model-reference.md)
 
+> [Get answers in Slack with Metabot](10-metabot.md)
+
 Let's get started with an overview of [What Metabase does](01-what-is-metabase.md).