Synchronized rst and markdown docs

With small English fixes. Later on, README.md will have link to the readthedocs rst-generated docs

Author: grigoryvp

.gitignore

@@ -104,4 +104,7 @@ ENV/
 # IDE settings
 .vscode/
 local_*.py
-.idea/
+.idea/
+
+# readthedocs sphinx generated documentation
+_build/

README.md

@@ -16,10 +16,10 @@ Installation
 ------------
 `pip install toggl-python` or use [poetry](https://python-poetry.org) `poetry add toggl-python`
 
-Features
---------
+Usage example
+-------------
 
-- Get TimeEntries.
+Get authenticated user time entries:
 
 ```python
 from toggl_python import TokenAuth, TimeEntries
@@ -29,7 +29,7 @@ if __name__ == "__main__":
     print(TimeEntries(auth=auth).list())
 ```
 
-- Get toggl User.
+Get information about the authenticated user:
 
 ```python
 from toggl_python import TokenAuth, Users
@@ -39,7 +39,7 @@ if __name__ == "__main__":
     print(Users(auth=auth).me())
 ```
 
-- Get toggl Workspaces.
+Get information about authenticated user workspaces:
 
 ```python
 from toggl_python import TokenAuth, Workspaces
@@ -49,8 +49,6 @@ if __name__ == "__main__":
     print(Workspaces(auth=auth).list())
 ```
 
-* *TODO*
-
 Credits
 -------
 

docs/index.rst

@@ -1,6 +1,46 @@
 Toggl Python API
 ================
 
+.. image:: https://evrone.com/logo/evrone-sponsored-logo.png
+  :width: 231
+  :alt: Sponsored by evrone.com
+  :target: https://evrone.com/?utm_source=github.com
+
+Based on open `Toggl API documentation <https://github.com/toggl/toggl_api_docs/blob/master/toggl_api.md>`_
+
 Installation
 ============
 `pip install toggl-python` or use `poetry <https://python-poetry.org>`_ `poetry add toggl-python`
+
+Usage example
+=============
+
+Get authenticated user time entries:
+
+.. code-block:: python
+
+  from toggl_python import TokenAuth, TimeEntries
+
+  if __name__ == "__main__":
+      auth = TokenAuth('AUTH_TOKEN')
+      print(TimeEntries(auth=auth).list())
+
+Get information about authenticated user:
+
+.. code-block:: python
+
+  from toggl_python import TokenAuth, Users
+
+  if __name__ == "__main__":
+      auth = TokenAuth('AUTH_TOKEN')
+      print(Users(auth=auth).me())
+
+Get information about authenticated user workspaces:
+
+.. code-block:: python
+
+  from toggl_python import TokenAuth, Workspaces
+
+  if __name__ == "__main__":
+      auth = TokenAuth('AUTH_TOKEN')
+      print(Workspaces(auth=auth).list())