Add usage examples

CHANGELOG.rst

@@ -2,11 +2,17 @@ A note on versioning: This librarys major version will grow with the APIs
 version number. Breaking changes will be indicated by a change in the minor
 (or major) version number, and will generally be avoided.  
 
-v1.8.0 (in progress)
+v1.8.1 (in progress)
 --------------------
 * Replace some lambdas with list comprenehsions (thanks eumiro)
 * Add `resolve` keyword to `account_search` (thanks zevaryx)
 * Add support for user agent header in `create_app` (thanks jkawamoto)
+* Update tox.ini for newer versions (thanks jkawamoto)
+* Various doc and argument check fixes (thanks cnotin, codl, alexmshepherd)
+* Fix magic not working on windows (thanks xloem)
+* Add readme to PyPi page (thanks hugovk)
+* Fix `list_accounts` to actually include request parameters (thanks leoncowle)
+* Small formatting changes (thanks amaargiru)
 
 v1.8.0
 ------

README.rst

@@ -43,7 +43,8 @@ We currently try to support Python 3.7 and above, and try to at least not break
 below that. Python 2 support is no longer a goal.
 
 Full documentation and basic usage examples can be found
-at https://mastodonpy.readthedocs.io/en/stable/
+at https://mastodonpy.readthedocs.io/en/stable/ . Some more extensive examples can be
+found at https://github.com/halcy/MastodonpyExamples
 
 Acknowledgements
 ----------------

docs/index.rst

@@ -55,6 +55,10 @@ as forks, while not an official target, should also be basically
 compatible, and Mastodon.py does make some allowances for behaviour that isn't
 strictly like that of Mastodon, and attempts to support extensions to the API.
 
+Some usage examples (not neccesarily following app development best practices,
+but enough to get you started if you learn best by example) can be found
+at https://github.com/halcy/MastodonpyExamples
+
 Acknowledgements
 ----------------
 Mastodon.py contains work by a large number of contributors, many of which have