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

2026-07-06 23:17:06 +02:00
parent c48f5ef215
commit a19b67eb84
27 changed files with 99 additions and 193 deletions
@@ -65,11 +65,9 @@ class LoadableStateConsumer<
    final showError = hasError && !hasContent;
    final showErrorBar = hasError && hasContent;

-    // Keep the wrapper hierarchy stable across refresh cycles. The bloc clears
-    // reFetch to null while a refetch is in flight and restores it on
-    // completion; flipping the RefreshIndicator in and out on that signal
-    // would change the widget tree under the ListView and reset its scroll
-    // position every refresh.
+    // Keep the wrapper hierarchy stable across refresh cycles: reFetch flips to
+    // null mid-refetch, and toggling the RefreshIndicator on that signal would
+    // rebuild the tree under the ListView and reset its scroll position.
    final content = SizedBox(
      height: MediaQuery.of(context).size.height,
      child: hasContent