Adds quickstart (#664)

Author: sobolevn

CONTRIBUTING.md

@@ -1,5 +1,9 @@
 # How to contribute
 
+Do you have questions or issues? Join our chat!
+
+[![Telegram chat](https://img.shields.io/badge/chat-join-blue?logo=telegram)](https://t.me/drypython)
+
 ## Tutorials
 
 If you want to start working on this project,
@@ -65,7 +69,7 @@ poetry run pytest typesafety
 
 **NOTE:** This can take upwards of 20 minutes, only recommended to run if necessary.
 
-Here's [a helpful tutorial](https://sobolevn.me/2019/08/testing-mypy-types) if you are looking 
+Here's [a helpful tutorial](https://sobolevn.me/2019/08/testing-mypy-types) if you are looking
 for more information.
 
 
@@ -123,5 +127,5 @@ It would also be a huge contribution to write
 a short article on how you are using this project.
 You can also share your best practices with us.
 
-Join in the conversation with us on our Telegram. 
+Join in the conversation with us on our Telegram.
 [![Telegram chat](https://img.shields.io/badge/chat-join-blue?logo=telegram)](https://t.me/drypython)

README.md

@@ -28,6 +28,8 @@ Make your functions return something meaningful, typed, and safe!
 - Support functions and coroutines, framework agnostic
 - Easy to start: has lots of docs, tests, and tutorials
 
+[Quickstart](https://returns.readthedocs.io/en/latest/pages/quickstart.html) right now!
+
 
 ## Installation
 

docs/index.rst

@@ -3,6 +3,11 @@
 Contents
 --------
 
+.. toctree::
+  :maxdepth: 2
+
+  pages/quickstart.rst
+
 .. toctree::
   :maxdepth: 2
   :caption: Userguide

docs/pages/contrib/mypy_plugins.rst

@@ -3,10 +3,9 @@
 mypy plugin
 ===========
 
-We provide several ``mypy`` plugins to fix existing issues
-and improve type-safety of things developers commonly use:
-
-- ``returns_plugin`` to solve untyped `decorator issue <https://github.com/python/mypy/issues/3157>`_ and add better :ref:`curry` support
+We provide a custom ``mypy`` plugin to fix existing issues,
+provide new awesome features,
+and improve type-safety of things developers commonly use.
 
 
 Installation

docs/pages/development.rst

@@ -1,5 +1,7 @@
-Development
-===========
+.. _development-tooling:
+
+Development tooling
+===================
 
 Tracing Failures
 ----------------

docs/pages/quickstart.rst

@@ -0,0 +1,65 @@
+Quickstart
+==========
+
+Starting is really fast!
+You can intergrate ``returns`` into any project at any stage.
+You can use it fully or partially. With or without types.
+
+``returns`` is a very flexible library!
+
+You can even just start using it without any deep theory around this project.
+But, you can always address our learning materials
+which will unravel all parts of functional programming
+with useful examples and simple terms.
+
+
+Installation
+------------
+
+``returns`` is a pure Python library. Install it as usual:
+
+.. code:: bash
+
+  pip install returns  # or better use poetry
+
+
+Typechecking and other integrations
+-----------------------------------
+
+This step is optional.
+If you use ``mypy`` for type-checking, than you will need to configure it.
+We really recommend using ``mypy`` with this project though.
+Because we have put a lot of efforts into the typing part.
+
+Check out our docs on :ref:`mypy <mypy-plugins>`.
+
+We also have built-in integrations
+with :ref:`pytest <pytest-plugins>` and :ref:`hypothesis <hypothesis-plugins>`.
+Also, there is :ref:`developer tooling <development-tooling>` you might enjoy.
+
+
+Theory
+------
+
+Do you want to learn new awesome concepts?
+Then, start reading our "Userguide"!
+
+It has everything you need! Reading order matters.
+
+However, this is optional.
+You can still use ``returns`` without a deep-dive into theory.
+
+
+Building your own stuff
+-----------------------
+
+You can extend ``returns`` and build your own stuff!
+Particullary, you can add new interfaces, new containers, and new integrations.
+See :ref:`this guide <create-your-own-container>`.
+
+|Telegram chat|
+
+.. |Telegram chat| image:: https://img.shields.io/badge/chat-join-blue?logo=telegram
+   :target: https://t.me/drypython
+
+Join our chat to get help or advice.