doc fixes

Author: 3nids

docs/docs/api/role_check_result.md

@@ -1 +1 @@
-::: pum.RoleCheckResult
+::: pum.RoleInventory

docs/mkdocs.yml

@@ -9,9 +9,6 @@ theme:
   logo: assets/images/pum.png
   favicon: assets/images/favicon.ico
   features:
-  #   - navigation.tabs
-  #   - navigation.tabs.sticky
-  #   - navigation.expand
     - navigation.indexes
     - navigation.top
     - navigation.tracking
@@ -112,7 +109,7 @@ nav:
       - PermissionType: api/permission_type.md
       - PumConfig: api/pum_config.md
       - Role: api/role.md
-      - RoleCheckResult: api/role_check_result.md
+      - RoleInventory: api/role_check_result.md
       - RoleManager: api/role_manager.md
       - RoleStatus: api/role_status.md
       - SchemaPermissionStatus: api/schema_permission_status.md

pum/hook.py

@@ -59,8 +59,7 @@ def execute(
         This is not committing the transaction and will be handled afterwards.
 
         Args:
-            connection: The database connection.
-            sql: The SQL statement to execute or a path to a SQL file..
+            sql: The SQL statement to execute or a path to a SQL file.
         """
         parameters_literals = SqlContent.prepare_parameters(self._parameters)
         SqlContent(sql).execute(
@@ -88,9 +87,9 @@ def __init__(
         """Initialize a Hook instance.
 
         Args:
-            type: The type of the hook (e.g., "pre", "post").
             file: The file path of the hook.
             code: The SQL code for the hook.
+            base_path: The base path for resolving relative file paths.
 
         """
         if file and code:

pum/sql_content.py

@@ -338,7 +338,7 @@ def format_sql(
         return [format_sql(statement, parameters) for statement in sql_code]
 
     @staticmethod
-    def prepare_parameters(parameters: dict | None):
+    def prepare_parameters(parameters: dict | None) -> dict:
         """
         Prepares a dictionary of parameters for use in SQL queries by converting each value to a psycopg.sql.Literal.
 

pum/upgrader.py

@@ -35,8 +35,6 @@ def __init__(
         The table is created in the schema defined in the config file if it does not exist.
 
         Args:
-            connection:
-                The database connection to use for the upgrade.
             config:
                 The configuration object
             max_version: