refactored and condensed technical documentation and comments across the codebase to improve readability

lib/storage/dev_tools_settings.dart

@@ -25,12 +25,9 @@ class DevToolsSettings {
     this.marianumConnectCustomUrl = '',
   });
 
-  // Resolves the effective base URL for the Marianum-Connect mobile API.
-  // Falls back to live when the custom URL is empty or malformed. HTTP is
-  // accepted alongside HTTPS only in debug/profile builds (developers can
-  // point at `http://10.0.2.2:8080` without configuring TLS locally); release
-  // builds restrict the custom endpoint to HTTPS so a leaked debug URL never
-  // ships an unencrypted bearer token over the wire.
+  // Resolves the effective base URL, falling back to live when the custom URL
+  // is empty or malformed. HTTP custom endpoints are allowed only outside
+  // release builds so a leaked debug URL never ships a plaintext bearer token.
   String resolveMarianumConnectBaseUrl() {
     switch (marianumConnectEndpoint) {
       case MarianumConnectEndpoint.live: