fix(README): Update documented content for future contributions (#18)

* chore(CONTRIBUTING): Add a contributing page

* chore(README): Update readme with links to new resources

* fix(README): Fix typos in new content

Author: navneetrao

Diff for: CONTRIBUTING.md

@@ -0,0 +1,7 @@
+## How to contribute
+
+If you'd like to contribute, start by searching through the [issues](https://github.com/watson-developer-cloud/assistant-dialog-skill-analysis/issues) and [pull requests](https://github.com/watson-developer-cloud/assistant-dialog-skill-analysis/pulls) to see if anyone else has raised a similar issue.
+
+If you don't see an issue listed, and you think it fits into the intended use of this repository, do this:
+* **If your contribution is minor,** such as a bug fix, open a pull request.
+* **If your contribution is major,** such as a new feature, start by opening an issue first. Others can then weigh in before you commence any work.

Diff for: README.md

@@ -1,16 +1,26 @@
 # Dialog Skill Analysis for Watson Assistant
 
 ## Introduction
-Dialog Skill Analysis for Watson Assistant is intended for use by chatbot designers and developers who would like to recognize and remediate issues in the design of their dialog skill 
+Dialog Skill Analysis is a Python framework along with an easy-to-use Python notebook to help you quickly and effectively build AI assistants using Watson Assistant 
 
-We assume familiarity with the Watson Assistant product as well as concepts involved in dialog skill design like intent, entities, utterances etc.
+Whether you are new to the process and are building your first AI assistant or you’re a veteran and have an assistant working well in production, this framework is intended to help everyone with questions like...
+- How do I know my assistant is doing a good job?
+- How do I test and measure my assistant’s performance?
+- Why is the assistant responding incorrectly to this question?
+- How do I improve my assistant’s ability to understand questions?
 
 ## Usage
 1. Assumes familiarity using a Python Jupyter notebook
 2. Assumes a Python 3.6 or greater environment (We recommend using Anaconda to setup a python environment)
 3. Install dependencies with `pip install -r requirements.txt`
 4. Start jupyter server with `jupyter notebook`
-5. Select `skill_analysis.ipynb` to start session
+5. Run `skill_analysis.ipynb` to start session
+
+## Guides
+An introduction to Dialog Skill Analysis on Medium: [Announcing Dialog Skill Analysis](https://medium.com/ibm-watson/announcing-dialog-skill-analysis-for-watson-assistant-83cdfb968178?)
+
+## Hosted Python Notebook
+For those of you familiar with IBM Watson Studio, we have also made a hosted version of the notebook available on the IBM Gallery: [Hosted Dialog Skill Analysis Notebook](https://dataplatform.cloud.ibm.com/exchange/public/entry/view/4d77701840fcb2f21587e39fdb887049)
 
 ## Contributor List