Documentation update

Author: febus982

README.md

@@ -189,7 +189,7 @@ to check [SQLAlchemy asyncio documentation](https://docs.sqlalchemy.org/en/20/or
 
 ## Repository / Unit of work
 
-The `SQLAlchemyRepository` and `SQLAlchemyAsyncRepository` class can be used simply by extending them.
+The `SQLAlchemyRepository` and `SQLAlchemyAsyncRepository` class can be used directly or by extending them.
 
 ```python
 from sqlalchemy_bind_manager.repository import SQLAlchemyRepository
@@ -198,12 +198,17 @@ from sqlalchemy_bind_manager.repository import SQLAlchemyRepository
 class MyModel(model_declarative_base):
     pass
 
+# Direct usage
+repo_instance = SQLAlchemyRepository(sqlalchemy_bind_manager.get_bind(), model_class=MyModel)
 
 class ModelRepository(SQLAlchemyRepository[MyModel]):
     _model = MyModel
+    
+    def _some_custom_method_implemented(self):
+        ...
 
-
-repo_instance = ModelRepository(sqlalchemy_bind_manager.get_bind())
+# Extended class usage
+extended_repo_instance = ModelRepository(sqlalchemy_bind_manager.get_bind())
 ```
 
 The classes provide some common use methods:
@@ -253,7 +258,6 @@ approach for multiple operations.
 
 We can use the `UnitOfWork` or the `AsyncUnitOfWork` class to provide a shared session to
 be used for repository operations, **assumed the same bind is used for all the repositories**.
-(Two phase transactions are not currently supported).
 
 ```python
 class MyRepo(SQLAlchemyRepository):

docs/index.md

@@ -75,13 +75,15 @@ with sa_manager.get_session() as session:
     session.commit()
 ```
 
-??? warning "Long lived sessions and multithreading"
-    It's not recommended to create long-lived sessions like:
-
-    ```
-    session = sa_manager.get_session()
-    ```
-    
-    This can create problems because of global variables and multi-threading.
-    More details can be found in the [session page](/manager/session/#note-on-multithreaded-applications)
-    
+/// details | Long lived sessions and multithreading
+    type: warning
+
+It's not recommended to create long-lived sessions like:
+
+```
+session = sa_manager.get_session()
+```
+
+This can create unexpected because of global variables and multi-threading.
+More details can be found in the [session page](/manager/session/#note-on-multithreaded-applications)
+///

docs/manager/models.md

@@ -20,6 +20,7 @@ Or using the imperative approach:
 ```python
 from dataclasses import dataclass
 from sqlalchemy import Integer, String, Table, Column
+
 @dataclass
 class MyModel:
     id: int

docs/repository/repository.md

@@ -1,20 +1,22 @@
 ## Repository / Unit of work
 
-The `SQLAlchemyRepository` and `SQLAlchemyAsyncRepository` class can be used simply by extending them.
+The `SQLAlchemyRepository` and `SQLAlchemyAsyncRepository` class can be used directly or by extending them.
 
 ```python
 from sqlalchemy_bind_manager.repository import SQLAlchemyRepository
 
 
-class MyModel(model_declarative_base_from_sa_manager_bind):
+class MyModel(model_declarative_base):
     pass
 
+# Direct usage
+repo_instance = SQLAlchemyRepository(sqlalchemy_bind_manager.get_bind(), model_class=MyModel)
 
 class ModelRepository(SQLAlchemyRepository[MyModel]):
     _model = MyModel
-
-
-repo_instance = ModelRepository(sqlalchemy_bind_manager.get_bind())
+    
+    def _some_custom_method_implemented(self):
+        ...
 ```
 
 The classes provide some common use methods:

docs/repository/uow.md

@@ -5,8 +5,11 @@ repository provide by itself an isolated session for single operations, we have
 approach for multiple operations.
 
 We can use the `UnitOfWork` or the `AsyncUnitOfWork` class to provide a shared session to
-be used for repository operations, **assumed the same bind is used for all the repositories**.
-(Two phase transactions are not currently supported).
+be used for repository operations, **assuming the same bind is used for all the repositories**.
+
+/// admonition | The direct use of `SQLAlchemyRepository` and `SQLAlchemyAsyncRepository` classes is not yet supported
+    type: warning
+///
 
 ```python
 class MyRepo(SQLAlchemyRepository):

mkdocs.yml

@@ -21,5 +21,6 @@ nav:
       - Unit of work: repository/uow.md
 
 markdown_extensions:
-  - pymdownx.snippets
   - pymdownx.details
+  - pymdownx.blocks.admonition
+  - pymdownx.blocks.details