From e9be8d6cb9fbe7ff08019a6addebff5cb2b3108e Mon Sep 17 00:00:00 2001
From: Komyyy <pol_tta@outlook.jp>
Date: Thu, 6 Feb 2025 23:21:49 +0900
Subject: [PATCH] docs

---
 lib/widgets/profile.dart | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/lib/widgets/profile.dart b/lib/widgets/profile.dart
index 8dc4c34c14..9034e5e4fe 100644
--- a/lib/widgets/profile.dart
+++ b/lib/widgets/profile.dart
@@ -314,7 +314,7 @@ class _UserWidget extends StatelessWidget {
   }
 }
 
-@visibleForTesting
+/// The text of current time in [user]'s timezone.
 class UserLocalTimeText extends StatelessWidget {
   const UserLocalTimeText({
     super.key,
@@ -323,6 +323,11 @@ class UserLocalTimeText extends StatelessWidget {
 
   final User user;
 
+  /// Initialize the timezone database used to know time difference from a timezone string.
+  ///
+  /// Usually, database initialization is done using `initializeTimeZones`, but it takes >100ms and not asynchronous.
+  /// So, we initialize database from the assets file copied from timezone library.
+  /// This file is checked up-to-date in `test/widgets/profile_test.dart`.
   static Future<void> initializeTimezonesUsingAssets() async {
     final blob = Uint8List.sublistView(await rootBundle.load('assets/timezone/latest_all.tzf'));
     tz.initializeDatabase(blob);