GH-15: Shorten README by removing the docs from it

Author: ArtyomVancyan

README.md

@@ -6,72 +6,15 @@
 [![Tests](https://github.com/pysnippet/fastapi-oauth2/actions/workflows/tests.yml/badge.svg)](https://github.com/pysnippet/fastapi-oauth2/actions/workflows/tests.yml)
 [![Docs](https://github.com/pysnippet/fastapi-oauth2/actions/workflows/docs.yml/badge.svg)](https://github.com/pysnippet/fastapi-oauth2/actions/workflows/docs.yml)
 
-FastAPI OAuth2 is a middleware-based social authentication mechanism supporting several identity providers. It depends
-on the [social-core](https://github.com/python-social-auth/social-core) authentication backends.
-
-## Installation
-
-```shell
-python -m pip install fastapi-oauth2
-```
-
-## Configuration
-
-Configuration requires you to provide the JWT requisites and define the clients of the particular providers. The
-middleware configuration is declared with the `OAuth2Config` and `OAuth2Client` classes.
-
-### OAuth2Config
-
-- `allow_http` - Allow insecure HTTP requests. Defaults to `False`.
-- `jwt_secret` - The secret key used to sign the JWT. Defaults to `None`.
-- `jwt_expires` - The expiration time of the JWT in seconds. Defaults to `900`.
-- `jwt_algorithm` - The algorithm used to sign the JWT. Defaults to `HS256`.
-- `clients` - The list of the OAuth2 clients. Defaults to `[]`.
-
-### OAuth2Client
-
-- `backend` - The [social-core](https://github.com/python-social-auth/social-core) authentication backend classname.
-- `client_id` - The OAuth2 client ID for the particular provider.
-- `client_secret` - The OAuth2 client secret for the particular provider.
-- `redirect_uri` - The OAuth2 redirect URI to redirect to after success. Defaults to the base URL.
-- `scope` - The OAuth2 scope for the particular provider. Defaults to `[]`.
-- `claims` - Claims mapping for the certain provider.
-
-It is also important to mention that for the configured clients of the auth providers, the authorization URLs are
-accessible by the `/oauth2/{provider}/auth` path where the `provider` variable represents the exact value of the auth
-provider backend `name` attribute.
-
-```python
-from fastapi_oauth2.claims import Claims
-from fastapi_oauth2.client import OAuth2Client
-from fastapi_oauth2.config import OAuth2Config
-from social_core.backends.github import GithubOAuth2
-
-oauth2_config = OAuth2Config(
-    allow_http=False,
-    jwt_secret=os.getenv("JWT_SECRET"),
-    jwt_expires=os.getenv("JWT_EXPIRES"),
-    jwt_algorithm=os.getenv("JWT_ALGORITHM"),
-    clients=[
-        OAuth2Client(
-            backend=GithubOAuth2,
-            client_id=os.getenv("OAUTH2_CLIENT_ID"),
-            client_secret=os.getenv("OAUTH2_CLIENT_SECRET"),
-            redirect_uri="https://pysnippet.org/",
-            scope=["user:email"],
-            claims=Claims(
-                picture="avatar_url",
-                identity=lambda user: "%s:%s" % (user.get("provider"), user.get("id")),
-            ),
-        ),
-    ]
-)
-```
+FastAPI OAuth2 is a middleware-based social authentication mechanism supporting several OAuth2 providers. It leverages
+the [social-core](https://github.com/python-social-auth/social-core) authentication backends and integrates seamlessly
+with FastAPI applications.
 
 ## Integration
 
-To integrate the package into your FastAPI application, you need to add the `OAuth2Middleware` with particular configs
-in the above-represented format and include the router to the main router of the application.
+For integrating the package into an existing FastAPI application, the router with OAuth2 routes and
+the `OAuth2Middleware` with particular [configs](https://docs.pysnippet.org/fastapi-oauth2/integration/configuration)
+should be added to the application.
 
 ```python
 from fastapi import FastAPI
@@ -80,24 +23,14 @@ from fastapi_oauth2.router import router as oauth2_router
 
 app = FastAPI()
 app.include_router(oauth2_router)
-app.add_middleware(OAuth2Middleware, config=oauth2_config)
-```
-
-After adding the middleware, the `user` attribute will be available in the request context. It will contain the user
-data provided by the OAuth2 provider.
-
-```jinja2
-{% if request.user.is_authenticated %}
-    <a href="/oauth2/logout">Sign out</a>
-{% else %}
-    <a href="/oauth2/github/auth">Sign in</a>
-{% endif %}
+app.add_middleware(OAuth2Middleware, config=OAuth2Config(...))
 ```
 
 ## Contribute
 
-Any contribution is welcome. If you have any ideas or suggestions, feel free to open an issue or a pull request. And
-don't forget to add tests for your changes.
+Any contribution is welcome. Always feel free to open an issue or a discussion if you have any questions not covered by
+the documentation. If you have any ideas or suggestions, please, open a pull request. Your name will shine in our
+contributors' list. Be proud of what you build!
 
 ## License