docs update

Signed-off-by: chandr-andr (Kiselev Aleksandr) <chandr@chandr.net>

Author: chandr-andr

.gitignore

@@ -76,4 +76,5 @@ _test*
 _load_test
 
 # JS
-node_modules
+node_modules
+.temp

docs/.vuepress/sidebar.ts

@@ -60,7 +60,6 @@ export default sidebar({
           collapsible: true,
           children: [
             "row_factories",
-            "overall_usage",
             "predefined_row_factories",
           ]
         },

docs/README.md

@@ -36,16 +36,27 @@ Don't make useless abstractions and make it like a mirror to `PostgreSQL`.
 It has all necessary components to create high-load and fault tolerance applications.
 
 ## How to install
-Using pip
+::: tabs
+@tab pip
+
 ```bash
 pip install psqlpy
 ```
 
-Using poetry
+@tab poetry
+
 ```bash
 poetry add psqlpy
 ```
 
+@tab git
+
+```bash
+pip install git+https://github.com/qaspen-python/psqlpy
+```
+
+:::
+
 ## Join community!
 You can get support from the creators and users of `PSQLPy` in some social media:
 - [Telegram](https://t.me/+f3Y8mYKgXxhmYThi)

docs/usage/row_factories/overall_usage.md

@@ -1,3 +1,36 @@
 ---
 title: Row Factories Usage
 ---
+
+`row_factory` must be used when you want to process result from Database in a custom way and return something different from dictionary.
+
+`row_factory` requires a function that accepts parameter `Dict[str, typing.Any]` and can return anything you want.
+
+::: tip
+`row_factory` can be a function or a class with `__call__` method which returns target converted instance.
+:::
+
+### Example:
+We create custom class and function with this class as a parameter and return function which will be used in processing row from database.
+```python
+@dataclass
+class ValidationTestModel:
+    id: int
+    name: str
+
+def to_class(
+    class_: Type[ValidationTestModel],
+) -> Callable[[Dict[str, Any]], ValidationTestModel]:
+    def to_class_inner(row: Dict[str, Any]) -> ValidationTestModel:
+        return class_(**row)
+
+    return to_class_inner
+
+async def main() -> None:
+    conn_result = await psql_pool.execute(
+        querystring=f"SELECT * FROM {table_name}",
+    )
+    class_res = conn_result.row_factory(row_factory=to_class(ValidationTestModel))
+
+    assert isinstance(class_res[0], ValidationTestModel)
+```