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
@@ -17,9 +17,8 @@ class SettingsCubit extends HydratedCubit<Settings> {
  Settings val({bool write = false}) {
    if (write) {
      // Defer the emit until the synchronous mutation on the returned object
-      // has finished. Without this scheduleMicrotask the cubit emits a copy
-      // captured *before* the assignment runs, so listeners (and HydratedBloc
-      // persistence) see the old value on the first emit.
+      // has finished — without this microtask the cubit emits a copy captured
+      // *before* the assignment, so listeners see the old value.
      if (!_emitScheduled) {
        _emitScheduled = true;
        scheduleMicrotask(() {