docs(misc): Some more documentation fixes

flaschengeist/__init__.py

@@ -1,8 +1,4 @@
-""" Server-package
+"""Flaschengeist"""
-
-    Initialize app, CORS, database and add it to the application.
-
-"""
 import logging
 import pkg_resources
 from pathlib import Path
@@ -10,5 +6,7 @@ from werkzeug.local import LocalProxy
 
 __version__ = pkg_resources.get_distribution("flaschengeist").version
 _module_path = Path(__file__).parent
+__pdoc__ = {}
 
 logger: logging.Logger = LocalProxy(lambda: logging.getLogger(__name__))
+__pdoc__["logger"] = "Flaschengeist's logger instance (`werkzeug.local.LocalProxy`)"

flaschengeist/controller/__init__.py

@@ -0,0 +1 @@
+"""Basic controllers for interaction with the Flaschengeist core"""

flaschengeist/controller/userController.py

@@ -99,7 +99,7 @@ def set_roles(user: User, roles: list[str], create=False):
         roles: List of role names
         create: If set to true, create not existing roles
     Raises:
-        BadRequest if invalid arguments given or not all roles found while `create` is set to false 
+        BadRequest if invalid arguments given or not all roles found while *create* is set to false
     """
     from roleController import create_role
 

flaschengeist/utils/__init__.py

@@ -0,0 +1 @@
+"""Common utilities"""