docs: module template docstrings

src/_module_template/config.py

@@ -1,7 +1,5 @@
 """
-Configurations for <this module>
+Configurations for the <this> module
 
-Configurations:
- - List: Description
- - Configs: Description
+Exports:
 """

src/_module_template/constants.py

@@ -1,7 +1,5 @@
 """
-Constants and error codes for <this module>
+Constants for the <this> module
 
-Constants:
- - List: Description
- - Consts: Description
+Exports:
 """

src/_module_template/dependencies.py

@@ -1,11 +1,6 @@
 """
-Router dependencies for <this module>
+Dependencies related to the <this> module
 
-Classes:
- - List: Description
- - Classes: Description
-
-Functions:
- - List: Description
- - Functions: Description
+Exports:
+ - <dep_name>: <return_type>: <description>
 """

src/_module_template/exceptions.py

@@ -1,7 +1,6 @@
 """
-Module specific exceptions for <this module>
+Exceptions related to the <this> modules
 
 Exceptions:
- - List: Description
- - Exceptions: Description
+ - <ExceptionName>: Details e.g. optional params
 """

src/_module_template/models.py

@@ -1,7 +1,9 @@
 """
-Database models for <this module>
+Database models for the <this> module
 
 Models:
- - List: Description
- - Models: Description
+ - <ModelName>:
+  - <normal_columns[FK][PK]>
+  - <orm_relationships>
+  - <calculated_properties>
 """

src/_module_template/router.py

@@ -1,13 +1,12 @@
 """
-Router endpoints for <this module>
+Router endpoints for the <this> module
 
-Endpoints:
- - List: Description
- - Endpoints: Description
+Exports:
+ - router: fastapi.APIRouter
 """
 from fastapi import APIRouter
 
 
-_router = APIRouter(
+router = APIRouter(
 	tags=[""],
-)
+)

src/_module_template/schemas.py

@@ -1,7 +1,8 @@
 """
-Pydantic models for <this module>
+Pydantic models for the <this> module
 
-Models:
- - List: Description
- - Models: Description
+Models follow the nomenclature of:
+- Sub-models: "<Resource><Opt:>Schema"
+- Mixins: "<Attribute>Mixin"
+- Models: "<Module><Method><Resource><Opt:Resource><Direction>" ie ""
 """

src/_module_template/service.py

@@ -1,11 +1,5 @@
 """
-Module specific business logic for <this module>
+Module specific business logic for the <this> module
 
-Classes:
- - List: Description
- - Classes: Description
-
-Functions:
- - List: Description
- - Functions: Description
+Exports:
 """

src/_module_template/utils.py

@@ -1,11 +1,3 @@
 """
-Non-business logic reusable functions and classes for <this module>
-
-Classes:
- - List: Description
- - Classes: Description
-
-Functions:
- - List: Description
- - Functions: Description
+Non-business logic reusable functions and classes for the <this> module
 """