Update readme

README.md

@@ -1,33 +1,39 @@
 # pytgvoip
 
-[![](https://img.shields.io/pypi/v/pytgvoip.svg?style=flat)](https://pypi.org/project/pytgvoip/) [![](https://img.shields.io/appveyor/ci/bakatrouble/pylibtgvoip.svg?label=windows%20wheels%20build&style=flat)](https://ci.appveyor.com/project/bakatrouble/pylibtgvoip) [![](https://img.shields.io/appveyor/ci/bakatrouble/libtgvoip.svg?label=libtgvoip%20windows%20build&style=flat)](https://ci.appveyor.com/project/bakatrouble/libtgvoip) ![](https://img.shields.io/pypi/l/pytgvoip.svg?style=flat)
+[![Read the Docs](https://img.shields.io/readthedocs/pytgvoip.svg)](https://pytgvoip.rtfd.io) [![PyPI](https://img.shields.io/pypi/v/pytgvoip.svg?style=flat)](https://pypi.org/project/pytgvoip/) [![AppVeyor (windows wheels)](https://img.shields.io/appveyor/ci/bakatrouble/pylibtgvoip.svg?label=windows%20wheels%20build&style=flat)](https://ci.appveyor.com/project/bakatrouble/pylibtgvoip) [![AppVeyor (libtgvoip)](https://img.shields.io/appveyor/ci/bakatrouble/libtgvoip.svg?label=libtgvoip%20windows%20build&style=flat)](https://ci.appveyor.com/project/bakatrouble/libtgvoip) ![LGPLv3+](https://img.shields.io/pypi/l/pytgvoip.svg?style=flat)
 
 **Telegram VoIP Library for Python**
 
-[Community](https://t.me/pytgvoip)
+[Community](https://t.me/pytgvoip) | [Documentation](https://pytgvoip.rtfd.io)
 
 **PytgVoIP** is a [Telegram](https://telegram.org/) VoIP library written in Python and C++.
 
 It uses [libtgvoip](https://github.com/grishka/libtgvoip) (a library used in official clients) 
 for voice encoding and transmission, and [pybind11](https://github.com/pybind/pybind11) for simple 
 generation of Python extension written in C++.
 
+It is targeted to MTProto client library developers, detailed usage guide is available [here](https://pytgvoip.readthedocs.io/en/latest/guides/usage.html).
+
+An example of usage with [Pyrogram](https://github.com/pyrogram/pyrogram) is available [here](https://github.com/bakatrouble/pytgvoip_pyrogram) ([`pytgvoip_pyrogram` in PyPI](https://pypi.org/project/pytgvoip_pyrogram/)), could be used as reference.
+
+Hopefully this module support will be [integrated in Pyrogram itself](https://github.com/pyrogram/pyrogram/pull/218), also [@cher-nov](https://github.com/cher-nov) has plans to integrate it into [Telethon](https://github.com/LonamiWebs/Telethon) as well
+
 ## Features
-* Making and receiving Telegram calls
 * Python callbacks for sending and receiving audio stream frames allow flexible control
 * Pre-built Windows wheels in PyPI
 
 ## Requirements
 * Python 3.4 or higher
-* An MTProto client (i.e. Pyrogram, Telethon)
 
 Linux, MacOS: (use binary wheels from PyPI for Windows)
-* [libtgvoip](docs/libtgvoip.md)
+* [libtgvoip](https://pytgvoip.readthedocs.io/en/latest/guides/libtgvoip.html)
 * CMake, C++11-compatible compiler, Python headers
 
 ## Installing
 ```pip3 install pytgvoip```
 
+Install [`pytgvoip_pyrogram`](https://github.com/bakatrouble/pytgvoip_pyrogram) to use this module with Pyrogram.
+
 
 ## Encoding audio streams
 Streams consumed by `libtgvoip` should be encoded in 16-bit signed PCM audio.