Add examples folder and routing from readme

CONTRIBUTING.rst

@@ -13,23 +13,24 @@
      ~
    -->
 
+=======================
 Contributing Guidelines
 =======================
 
 Pull Request Checklist
-----------------------
+======================
 
 -  Read the `contributing
-   guidelines <https://github.com/deepchecks/deepchecks/blob/master/CONTRIBUTING.md>`__.
+   guidelines <https://github.com/deepchecks/deepchecks/blob/master/CONTRIBUTING.rst>`__
 -  Check if your changes are consistent with the
-   `guidelines <https://github.com/deepchecks/deepchecks/blob/master/CONTRIBUTING.md#general-guidelines-and-philosophy-for-contribution>`__.
+   `guidelines <#general-guidelines-for-contribution>`__
 -  Changes are consistent with the `coding
-   style <https://github.com/deepchecks/deepchecks/blob/master/CONTRIBUTING.md#coding-style>`__
+   style <#coding-style>`__
 -  Run the `unit
-   tests <https://github.com/deepchecks/deepchecks/blob/master/CONTRIBUTING.md#running-unit-tests>`__.
+   tests <#running-unit-tests>`__
 
 General guidelines for contribution
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------------
 
 -  Include unit tests when you contribute new features, as they help to
    a) prove that your code works correctly, and b) guard against future
@@ -40,7 +41,7 @@ General guidelines for contribution
    your pull request will comment on any API compatibility issues.
 
 Coding Style
-^^^^^^^^^^^^
+------------
 
 Changes to Python code should pass both linting and docstring check, to
 make it easier with our contributors, we've included a ``makefile``
@@ -54,7 +55,7 @@ your code style, you can run
 which in turn will run ``pylint`` and ``pydocstring`` on the code.
 
 Running Unit Tests
-^^^^^^^^^^^^^^^^^^
+-------------------
 
 Every Pull Request Submitted will be checked on every supported Python
 version, in your on-going development, you can fall back to

FAQ.rst

@@ -12,3 +12,7 @@
      ~ ----------------------------------------------------------------------------
      ~
    -->
+
+===========================
+Frequently Asked Questions
+===========================

deepchecks/suites/README.rst

@@ -13,14 +13,15 @@
      ~
    -->
 
+======
 Suites
 ======
 
 Using an Existing Suite
------------------------
+=========================
 
-`List of Prebuilt Suites <./default_suites.py>`__
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+List of Prebuilt Suites
+---------------------------
 
 -  single_dataset_integrity - Runs a set of checks that are meant to
    detect integrity issues within a single dataset.
@@ -35,7 +36,7 @@ Using an Existing Suite
    checks.
 
 Running a Suite
-~~~~~~~~~~~~~~~
+----------------
 
 To run a prebuilt suite, first import it
 
@@ -50,7 +51,7 @@ Then run it with the required (suite-dependant) input parameters
    model_evaluation().run(model=my_classification_model, train_dataset=ds_train, test_dataset=ds_test)
 
 Creating Your Custom Suite
---------------------------
+============================
 
 Import Suite and Checks from deepchecks
 

examples/README.rst

@@ -0,0 +1,34 @@
+========
+Examples
+========
+
+Open from Docs - *Recommended*
+==============================
+
+All examples can be viewed in the 
+`Examples <https://docs.deepchecks.com/en/stable/examples/index.html?utm_source=github.com&utm_medium=referral&utm_campaign=readme&utm_content=examples_folder>`__
+section in the documentation.
+
+Note that they can be also be launched directly from the documentation,
+using google colab or binder,
+by clicking on the badges that each notebook has on the top right side:
+
+.. raw:: html
+
+   <p align="center">
+      <a href="https://docs.deepchecks.com/en/stable/examples/index.html?utm_source=github.com&utm_medium=referral&utm_campaign=readme&utm_content=examples_folder_image">
+      <img src="/docs/images/notebook-example-launch-badges.png">
+      </a>
+   </p>
+
+Download from Git
+===================
+
+Notice that viewing the notebooks within git **will not parse the graph outputs**.
+Having said that, if you still want to access the raw examples notebooks directly, you can head to the
+`examples folder <docs/source/examples>`__. 
+
+.. note::
+
+	In order to see the graphs when running a notebook locally, you need to `define it as **Trusted** <https://stackoverflow.com/questions/44943646/jupyter-notebook-not-trusted>`__
+