sync changes from PR: #13 to md docs sources

Author: krylosov-aa

docs_sources/docs/getting_started.md

@@ -2,7 +2,7 @@
 
 ## Configure the connection to the database
 
-For example, for PostgreSQL - database.py:
+For example, for PostgreSQL's database.py:
 
 ```python
 from sqlalchemy.ext.asyncio import (
@@ -52,16 +52,16 @@ connection = DBConnect(
 ```
 
 The **host** parameter is optional if you use a handler
-before creating a session - `before_create_session_handler`.
-In that case, you can dynamically set the host.
+before creating a session: `before_create_session_handler`.
+From there, you can dynamically set the host.
 
 Read more in [Master/Replica or several databases at the same time](master_replica.md)
 
 
-## Manage Database connection lifecycle
+## Manage the database connection lifecycle
 
 
-Close resources at the end of your application's lifecycle.
+Close the resources at the end of your application's lifecycle.
 
 Example for FastAPI:
 
@@ -82,10 +82,10 @@ async def lifespan(app: FastAPI) -> AsyncGenerator[None, Any]:
 
 ## Setup middleware
 
-Middleware handles the most important and complex part -
+Middleware handles the most important and complex parts:
 managing context and sessions.
 
-You can use the ready-made middleware components:
+You can use ready-made middleware components:
 
 ### Pure ASGI
 
@@ -119,9 +119,8 @@ add_starlette_http_db_session_middleware(app)
 
 ### Write own
 
-If there’s no ready-made solution that fits your needs - don’t worry!
-You can check out [how it works](how_middleware_works.md) and implement your
-own.
+If there’s no ready-made solution that fits your needs, don’t worry!
+You can check out [how it works](how_middleware_works.md) implement your own.
 
 
 ## Use it
@@ -155,14 +154,13 @@ async def some_func() -> None:
 
 ## Examples
 
-The repository includes an example integration with FastAPI, demonstrating
-various workflows:
-[FastAPI example](https://github.com/krylosov-aa/context-async-sqlalchemy/tree/main/examples/fastapi_example/routes)
+The repository includes an example integration with [FastAPI](https://github.com/krylosov-aa/context-async-sqlalchemy/tree/main/examples/fastapi_example/routes)
+demonstrating various workflows.
 
 It also contains two types of test setups that you can use in your own
 projects.
 
 All library tests are included within the examples - because we aim to
-test the functionality not in isolation, but in the context of a real
+test the functionality in the context of a real,
 asynchronous web application.
 [FastAPI tests example](https://github.com/krylosov-aa/context-async-sqlalchemy/tree/main/examples/fastapi_example/tests)

docs_sources/docs/problem.md

@@ -2,7 +2,7 @@
 
 SQLAlchemy uses an engine that manages the connection pool.
 The engine must remain active for as long as the application is
-running, so it can quickly provide ready-to-use connections whenever the
+running, providing ready-to-use connections whenever the
 application needs them.
 
 In the application, we work with sessions.
@@ -16,9 +16,9 @@ Let's see what existing solutions are available to manage sessions:
 
 ### Manual solution
 
-This is how the code ends up being duplicated,
-and two connections and two transactions are used - even though
-in many cases only one connection and one transaction are actually needed.
+This is how the code duplicates,
+and two connections and two transactions are in use - even when only one
+connection and one transaction are actually needed.
 
 ```python
 @app.post("/users/")
@@ -60,7 +60,7 @@ async def insert_user_profile(name, session):
     await session.execute(stmt)
 ```
 
-But if you look at it more broadly, the code duplication doesn’t actually go
+If you look at it more broadly, the code duplication doesn’t go
 away - you still have to do this in every handler.
 
 
@@ -79,9 +79,9 @@ async def create_cat(name):
             ...
 ```
 
-You also have to set everything up yourself.
-No ready-made integration solutions are used - which means freedom on one
-hand, but a lot of code on the other.
+You also have to set everything up manually.
+No ready-made integration solutions are available - which means freedom
+but also a lot of coding.
 
 ### Dependency