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
@@ -44,11 +44,9 @@ class FilesBloc
    await _query(path, renew: true);
  }

-  /// LoadableState.reFetch (used by the pull-to-refresh indicator and the
-  /// error-screen retry button) routes through here. The inherited retry()
-  /// goes via gatherData() which respects the cache TTL — for an explicit
-  /// user-initiated reload we must bypass it, otherwise the root listing
-  /// silently returns its day-old cached payload without hitting the server.
+  /// Pull-to-refresh and error-screen retry route through here. Unlike the
+  /// inherited retry() (via gatherData(), which respects the cache TTL), this
+  /// bypasses the TTL — otherwise the root listing returns its day-old cache.
  @override
  void retry() {
    unawaited(refresh());