chore(docs): Update README files.

Author: playpauseandstop

README.rst

@@ -2,7 +2,7 @@
 rororo
 ======
 
-.. image:: https://img.shields.io/circleci/project/github/playpauseandstop/rororo/master.svg
+.. image:: https://img.shields.io/circleci/project/github/playpauseandstop/rororo/feature-openapi.svg
     :target: https://circleci.com/gh/playpauseandstop/rororo
     :alt: CircleCI
 
@@ -18,7 +18,7 @@ rororo
     :target: https://github.com/playpauseandstop/rororo/blob/master/LICENSE
     :alt: BSD License
 
-.. image:: https://coveralls.io/repos/playpauseandstop/rororo/badge.svg?branch=master&service=github
+.. image:: https://coveralls.io/repos/playpauseandstop/rororo/badge.svg?branch=feature-openapi&service=github
     :target: https://coveralls.io/github/playpauseandstop/rororo
     :alt: Coverage
 
@@ -33,7 +33,51 @@ applications.
 As well as bunch other utilities to build effective web applications with
 Python 3 & ``aiohttp.web``.
 
-* Works on Python 3.5+
+* Works on Python 3.6+
 * BSD licensed
 * Source, issues, and pull requests `on GitHub
   <https://github.com/playpauseandstop/rororo>`_
+
+Quick Start
+===========
+
+``rororo`` relies on valid OpenAPI schema file (both JSON or YAML formats
+supported).
+
+Example below, illustrates on how to handle operation ``hello_world`` from
+`openapi.yaml <https://github.com/playpauseandstop/rororo/blob/feature-openapi/tests/openapi.yaml>`_
+schema file.
+
+.. code-block:: python
+
+    from pathlib import Path
+
+    from aiohttp import web
+
+    from rororo import openapi_context, OperationTableDef, setup_openapi
+
+
+    operations = OperationTableDef()
+
+
+    @operations.register
+    async def hello_world(request: web.Request) -> web.Response:
+        with openapi_context(request) as context:
+            name = context.parameters.query.get("name", "world")
+            return web.json_response({"message": f"Hello, {name}!"})
+
+
+    def create_app(argv: List[str] = None) -> web.Application:
+        app = web.Application()
+        setup_openapi(
+            app,
+            Path(__file__).parent / "openapi.yaml",
+            operations,
+            route_prefix="/api"
+        )
+        return app
+
+Check
+`examples <https://github.com/playpauseandstop/rororo/tree/feature-openapi/examples>`_
+folder to see other examples on how to use OpenAPI 3 schemas with aiohttp.web
+applications.

examples/petstore/README.rst

@@ -3,11 +3,12 @@ Pet Store
 =========
 
 ``aiohttp.web`` application to cover official OpenAPI 3
-`petstore-expanded.yaml <>`_ schema.
+`petstore-expanded.yaml <https://github.com/OAI/OpenAPI-Specification/blob/master/examples/v3.0/petstore-expanded.yaml>`_
+schema.
 
 Usage
 =====
 
 .. code-block:: python
 
-    python -m aiohttp.web app:create_app
+    python -m aiohttp.web petstore.app:create_app

setup.py

@@ -14,7 +14,7 @@
     'name': 'rororo',
     'version': '2.0.0a0',
     'description': 'OpenAPI 3 schema support for aiohttp.web applications.',
-    'long_description': '======\nrororo\n======\n\n.. image:: https://img.shields.io/circleci/project/github/playpauseandstop/rororo/master.svg\n    :target: https://circleci.com/gh/playpauseandstop/rororo\n    :alt: CircleCI\n\n.. image:: https://img.shields.io/pypi/v/rororo.svg\n    :target: https://pypi.org/project/rororo/\n    :alt: Latest Version\n\n.. image:: https://img.shields.io/pypi/pyversions/rororo.svg\n    :target: https://pypi.org/project/rororo/\n    :alt: Python versions\n\n.. image:: https://img.shields.io/pypi/l/rororo.svg\n    :target: https://github.com/playpauseandstop/rororo/blob/master/LICENSE\n    :alt: BSD License\n\n.. image:: https://coveralls.io/repos/playpauseandstop/rororo/badge.svg?branch=master&service=github\n    :target: https://coveralls.io/github/playpauseandstop/rororo\n    :alt: Coverage\n\n.. image:: https://readthedocs.org/projects/rororo/badge/?version=latest\n    :target: https://rororo.readthedocs.io/\n    :alt: Documentation\n\n`OpenAPI 3 <https://spec.openapis.org/oas/v3.0.2>`_ schema support\nfor `aiohttp.web <https://aiohttp.readthedocs.io/en/stable/web.html>`_\napplications.\n\nAs well as bunch other utilities to build effective web applications with\nPython 3 & ``aiohttp.web``.\n\n* Works on Python 3.5+\n* BSD licensed\n* Source, issues, and pull requests `on GitHub\n  <https://github.com/playpauseandstop/rororo>`_\n',
+    'long_description': '======\nrororo\n======\n\n.. image:: https://img.shields.io/circleci/project/github/playpauseandstop/rororo/feature-openapi.svg\n    :target: https://circleci.com/gh/playpauseandstop/rororo\n    :alt: CircleCI\n\n.. image:: https://img.shields.io/pypi/v/rororo.svg\n    :target: https://pypi.org/project/rororo/\n    :alt: Latest Version\n\n.. image:: https://img.shields.io/pypi/pyversions/rororo.svg\n    :target: https://pypi.org/project/rororo/\n    :alt: Python versions\n\n.. image:: https://img.shields.io/pypi/l/rororo.svg\n    :target: https://github.com/playpauseandstop/rororo/blob/master/LICENSE\n    :alt: BSD License\n\n.. image:: https://coveralls.io/repos/playpauseandstop/rororo/badge.svg?branch=feature-openapi&service=github\n    :target: https://coveralls.io/github/playpauseandstop/rororo\n    :alt: Coverage\n\n.. image:: https://readthedocs.org/projects/rororo/badge/?version=latest\n    :target: https://rororo.readthedocs.io/\n    :alt: Documentation\n\n`OpenAPI 3 <https://spec.openapis.org/oas/v3.0.2>`_ schema support\nfor `aiohttp.web <https://aiohttp.readthedocs.io/en/stable/web.html>`_\napplications.\n\nAs well as bunch other utilities to build effective web applications with\nPython 3 & ``aiohttp.web``.\n\n* Works on Python 3.6+\n* BSD licensed\n* Source, issues, and pull requests `on GitHub\n  <https://github.com/playpauseandstop/rororo>`_\n\nQuick Start\n===========\n\n``rororo`` relies on valid OpenAPI schema file (both JSON or YAML formats\nsupported).\n\nExample below, illustrates on how to handle operation ``hello_world`` from\n`openapi.yaml <https://github.com/playpauseandstop/rororo/blob/feature-openapi/tests/openapi.yaml>`_\nschema file.\n\n.. code-block:: python\n\n    from pathlib import Path\n\n    from aiohttp import web\n\n    from rororo import openapi_context, OperationTableDef, setup_openapi\n\n\n    operations = OperationTableDef()\n\n\n    @operations.register\n    async def hello_world(request: web.Request) -> web.Response:\n        with openapi_context(request) as context:\n            name = context.parameters.query.get("name", "world")\n            return web.json_response({"message": f"Hello, {name}!"})\n\n\n    def create_app(argv: List[str] = None) -> web.Application:\n        app = web.Application()\n        setup_openapi(\n            app,\n            Path(__file__).parent / "openapi.yaml",\n            operations,\n            route_prefix="/api"\n        )\n        return app\n\nCheck\n`examples <https://github.com/playpauseandstop/rororo/tree/feature-openapi/examples>`_\nfolder to see other examples on how to use OpenAPI 3 schemas with aiohttp.web\napplications.\n',
     'author': 'Igor Davydenko',
     'author_email': 'iam@igordavydenko.com',
     'url': 'https://igordavydenko.com/projects.html#rororo',