Skip to content

Commit d0fbac5

Browse files
fullenifulleni
committed
docs(l10n): update app configuration descriptions
- Improved descriptions for clarity - Renamed tabs for better UX - Added new sections for settings - Removed redundant descriptions - Updated translations for all languages
1 parent e94180e commit d0fbac5

File tree

5 files changed

+239
-129
lines changed

5 files changed

+239
-129
lines changed

‎lib/l10n/app_localizations.dart

Lines changed: 67 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -251,7 +251,7 @@ abstract class AppLocalizations {
251251
/// Description for the App Configuration page
252252
///
253253
/// In en, this message translates to:
254-
/// **'Configure global settings for the mobile application, including user content limits, ad display rules, in-app prompts, operational status, and force update parameters.'**
254+
/// **'Manage global settings for the mobile app, from content limits to operational status.'**
255255
String get appConfigurationPageDescription;
256256

257257
/// Label for the settings navigation item
@@ -266,29 +266,83 @@ abstract class AppLocalizations {
266266
/// **'App Configuration'**
267267
String get appConfigurationPageTitle;
268268

269-
/// Tab title for User Content Limits
269+
/// Tab title for Feed settings
270270
///
271271
/// In en, this message translates to:
272-
/// **'User Content Limits'**
273-
String get userContentLimitsTab;
272+
/// **'Feed'**
273+
String get feedTab;
274274

275-
/// Tab title for Ad Settings
275+
/// Tab title for Advertisements settings
276276
///
277277
/// In en, this message translates to:
278-
/// **'Ad Settings'**
279-
String get adSettingsTab;
278+
/// **'Advertisements'**
279+
String get advertisementsTab;
280280

281-
/// Tab title for In-App Prompts
281+
/// Tab title for General settings
282282
///
283283
/// In en, this message translates to:
284-
/// **'In-App Prompts'**
285-
String get inAppPromptsTab;
284+
/// **'General'**
285+
String get generalTab;
286286

287-
/// Tab title for App Operational Status
287+
/// Title for the User Content & Feed Limits section
288288
///
289289
/// In en, this message translates to:
290-
/// **'App Operational Status'**
291-
String get appOperationalStatusTab;
290+
/// **'User Content & Feed Limits'**
291+
String get userContentLimitsTitle;
292+
293+
/// Description for the User Content & Feed Limits section
294+
///
295+
/// In en, this message translates to:
296+
/// **'Set limits on followed items and saved headlines for each user tier.'**
297+
String get userContentLimitsDescription;
298+
299+
/// Title for the Feed Actions section
300+
///
301+
/// In en, this message translates to:
302+
/// **'Feed Actions'**
303+
String get feedActionsTitle;
304+
305+
/// Description for the Feed Actions section
306+
///
307+
/// In en, this message translates to:
308+
/// **'Configure how often to inject action widgets (e.g., \'Rate App\') into the feed.'**
309+
String get feedActionsDescription;
310+
311+
/// Title for the Advertisement Settings section
312+
///
313+
/// In en, this message translates to:
314+
/// **'Advertisement Settings'**
315+
String get adSettingsTitle;
316+
317+
/// Description for the Ad Settings section
318+
///
319+
/// In en, this message translates to:
320+
/// **'Manage ad frequency and placement for different user roles.'**
321+
String get adSettingsDescription;
322+
323+
/// Title for the Maintenance Mode section
324+
///
325+
/// In en, this message translates to:
326+
/// **'Maintenance Mode'**
327+
String get maintenanceModeTitle;
328+
329+
/// Description for the Maintenance Mode section
330+
///
331+
/// In en, this message translates to:
332+
/// **'Enable to show a maintenance screen to all users.'**
333+
String get maintenanceModeDescription;
334+
335+
/// Title for the Force App Update section
336+
///
337+
/// In en, this message translates to:
338+
/// **'Force App Update'**
339+
String get forceUpdateTitle;
340+
341+
/// Description for Force Update Configuration section
342+
///
343+
/// In en, this message translates to:
344+
/// **'These settings control app version enforcement. Users on versions below the minimum allowed will be forced to update.'**
345+
String get forceUpdateDescription;
292346

293347
/// Tab title for Force Update
294348
///
@@ -374,12 +428,6 @@ abstract class AppLocalizations {
374428
/// **'Confirm Save'**
375429
String get confirmSaveButton;
376430

377-
/// Description for User Content Limits section
378-
///
379-
/// In en, this message translates to:
380-
/// **'These settings define the maximum number of countries, news sources, topics, and saved headlines a user can follow or save. Limits vary by user type (Guest, Standard, Premium) and directly impact what content users can curate.'**
381-
String get userContentLimitsDescription;
382-
383431
/// Tab title for Guest user role
384432
///
385433
/// In en, this message translates to:
@@ -470,12 +518,6 @@ abstract class AppLocalizations {
470518
/// **'Maximum number of headlines a Premium user can save.'**
471519
String get premiumSavedHeadlinesLimitDescription;
472520

473-
/// Description for Ad Settings section
474-
///
475-
/// In en, this message translates to:
476-
/// **'These settings control how advertisements are displayed within the app\'s news feed, with different rules for Guest, Standard, and Premium users. \"Ad Frequency\" determines how often an ad can appear, while \"Ad Placement Interval\" sets how many news items must be shown before the very first ad appears.'**
477-
String get adSettingsDescription;
478-
479521
/// Tab title for Standard User in Ad Settings
480522
///
481523
/// In en, this message translates to:
@@ -590,12 +632,6 @@ abstract class AppLocalizations {
590632
/// **'Number of articles a Premium user needs to read before a full-screen interstitial ad is shown.'**
591633
String get premiumUserArticlesBeforeInterstitialAdsDescription;
592634

593-
/// Description for In-App Prompts section
594-
///
595-
/// In en, this message translates to:
596-
/// **'These settings control how often special in-app messages or \"prompts\" are shown to users in their news feed. These prompts encourage actions like linking an account (for guests) or upgrading to a premium subscription (for authenticated users). The frequency varies by user type.'**
597-
String get inAppPromptsDescription;
598-
599635
/// Warning message for changing app operational status
600636
///
601637
/// In en, this message translates to:
@@ -644,12 +680,6 @@ abstract class AppLocalizations {
644680
/// **'Force Update Configuration'**
645681
String get forceUpdateConfigurationTitle;
646682

647-
/// Description for Force Update Configuration section
648-
///
649-
/// In en, this message translates to:
650-
/// **'These settings control app version enforcement. Users on versions below the minimum allowed will be forced to update.'**
651-
String get forceUpdateDescription;
652-
653683
/// Label for Minimum Allowed App Version
654684
///
655685
/// In en, this message translates to:

‎lib/l10n/app_localizations_ar.dart

Lines changed: 37 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ class AppLocalizationsAr extends AppLocalizations {
9595

9696
@override
9797
String get appConfigurationPageDescription =>
98-
'تكوين الإعدادات العامة للتطبيق المحمول، بما في ذلك حدود محتوى المستخدم، وقواعد عرض الإعلانات، والتنبيهات داخل التطبيق، وحالة التشغيل، ومعلمات التحديث الإجباري.';
98+
'إدارة الإعدادات العامة لتطبيق الهاتف، من حدود المحتوى إلى الحالة التشغيلية.';
9999

100100
@override
101101
String get settings => 'الإعدادات';
@@ -104,16 +104,48 @@ class AppLocalizationsAr extends AppLocalizations {
104104
String get appConfigurationPageTitle => 'إعدادات التطبيق';
105105

106106
@override
107-
String get userContentLimitsTab => 'حدود محتوى المستخدم';
107+
String get feedTab => 'الموجز';
108108

109109
@override
110-
String get adSettingsTab => 'إعدادات الإعلانات';
110+
String get advertisementsTab => 'الإعلانات';
111111

112112
@override
113-
String get inAppPromptsTab => 'تنبيهات داخل التطبيق';
113+
String get generalTab => 'عام';
114114

115115
@override
116-
String get appOperationalStatusTab => 'حالة تشغيل التطبيق';
116+
String get userContentLimitsTitle => 'حدود المحتوى والموجز للمستخدم';
117+
118+
@override
119+
String get userContentLimitsDescription =>
120+
'تعيين حدود للعناصر المتابعة والعناوين المحفوظة لكل فئة من فئات المستخدمين.';
121+
122+
@override
123+
String get feedActionsTitle => 'إجراءات الموجز';
124+
125+
@override
126+
String get feedActionsDescription =>
127+
'تكوين عدد مرات إدراج ودجات الإجراءات (مثل \'تقييم التطبيق\') في الموجز.';
128+
129+
@override
130+
String get adSettingsTitle => 'إعدادات الإعلانات';
131+
132+
@override
133+
String get adSettingsDescription =>
134+
'إدارة تكرار وموضع الإعلانات لأدوار المستخدمين المختلفة.';
135+
136+
@override
137+
String get maintenanceModeTitle => 'وضع الصيانة';
138+
139+
@override
140+
String get maintenanceModeDescription =>
141+
'تمكين لعرض شاشة صيانة لجميع المستخدمين.';
142+
143+
@override
144+
String get forceUpdateTitle => 'فرض تحديث التطبيق';
145+
146+
@override
147+
String get forceUpdateDescription =>
148+
'تتحكم هذه الإعدادات في فرض إصدار التطبيق. سيتم إجبار المستخدمين الذين يستخدمون إصدارات أقل من الحد الأدنى المسموح به على التحديث.';
117149

118150
@override
119151
String get forceUpdateTab => 'تحديث إجباري';
@@ -162,10 +194,6 @@ class AppLocalizationsAr extends AppLocalizations {
162194
@override
163195
String get confirmSaveButton => 'تأكيد الحفظ';
164196

165-
@override
166-
String get userContentLimitsDescription =>
167-
'تحدد هذه الإعدادات الحد الأقصى لعدد البلدان ومصادر الأخبار والمواضيع والعناوين المحفوظة التي يمكن للمستخدم متابعتها أو حفظها. تختلف الحدود حسب نوع المستخدم (ضيف، عادي، مميز) وتؤثر بشكل مباشر على المحتوى الذي يمكن للمستخدمين تنسيقه.';
168-
169197
@override
170198
String get guestUserTab => 'ضيف';
171199

@@ -221,10 +249,6 @@ class AppLocalizationsAr extends AppLocalizations {
221249
String get premiumSavedHeadlinesLimitDescription =>
222250
'الحد الأقصى لعدد العناوين الرئيسية التي يمكن للمستخدم المميز حفظها.';
223251

224-
@override
225-
String get adSettingsDescription =>
226-
'تتحكم هذه الإعدادات في كيفية عرض الإعلانات ضمن موجز الأخبار في التطبيق، مع قواعد مختلفة للمستخدمين الضيوف والعاديين والمميزين. تحدد \"تكرار الإعلان\" عدد مرات ظهور الإعلان، بينما تحدد \"فترة وضع الإعلان\" عدد عناصر الأخبار التي يجب عرضها قبل ظهور الإعلان الأول.';
227-
228252
@override
229253
String get standardUserAdTab => 'مستخدم عادي';
230254

@@ -296,10 +320,6 @@ class AppLocalizationsAr extends AppLocalizations {
296320
String get premiumUserArticlesBeforeInterstitialAdsDescription =>
297321
'عدد المقالات التي يحتاج المستخدم المميز لقراءتها قبل عرض إعلان بيني بملء الشاشة.';
298322

299-
@override
300-
String get inAppPromptsDescription =>
301-
'تتحكم هذه الإعدادات في عدد مرات عرض الرسائل الخاصة داخل التطبيق أو \"التنبيهات\" للمستخدمين في موجز الأخبار الخاص بهم. تشجع هذه التنبيهات على إجراءات مثل ربط حساب (للضيوف) أو الترقية إلى اشتراك مميز (للمستخدمين الموثقين). يختلف التكرار حسب نوع المستخدم.';
302-
303323
@override
304324
String get appOperationalStatusWarning =>
305325
'تحذير: قد يؤثر تغيير حالة تشغيل التطبيق على جميع المستخدمين. استخدم بحذر شديد.';
@@ -328,10 +348,6 @@ class AppLocalizationsAr extends AppLocalizations {
328348
@override
329349
String get forceUpdateConfigurationTitle => 'إعدادات التحديث الإجباري';
330350

331-
@override
332-
String get forceUpdateDescription =>
333-
'تتحكم هذه الإعدادات في فرض إصدار التطبيق. سيتم إجبار المستخدمين الذين يستخدمون إصدارات أقل من الحد الأدنى المسموح به على التحديث.';
334-
335351
@override
336352
String get minAllowedAppVersionLabel =>
337353
'الحد الأدنى المسموح به لإصدار التطبيق';

‎lib/l10n/app_localizations_en.dart

Lines changed: 37 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ class AppLocalizationsEn extends AppLocalizations {
9494

9595
@override
9696
String get appConfigurationPageDescription =>
97-
'Configure global settings for the mobile application, including user content limits, ad display rules, in-app prompts, operational status, and force update parameters.';
97+
'Manage global settings for the mobile app, from content limits to operational status.';
9898

9999
@override
100100
String get settings => 'Settings';
@@ -103,16 +103,48 @@ class AppLocalizationsEn extends AppLocalizations {
103103
String get appConfigurationPageTitle => 'App Configuration';
104104

105105
@override
106-
String get userContentLimitsTab => 'User Content Limits';
106+
String get feedTab => 'Feed';
107107

108108
@override
109-
String get adSettingsTab => 'Ad Settings';
109+
String get advertisementsTab => 'Advertisements';
110110

111111
@override
112-
String get inAppPromptsTab => 'In-App Prompts';
112+
String get generalTab => 'General';
113113

114114
@override
115-
String get appOperationalStatusTab => 'App Operational Status';
115+
String get userContentLimitsTitle => 'User Content & Feed Limits';
116+
117+
@override
118+
String get userContentLimitsDescription =>
119+
'Set limits on followed items and saved headlines for each user tier.';
120+
121+
@override
122+
String get feedActionsTitle => 'Feed Actions';
123+
124+
@override
125+
String get feedActionsDescription =>
126+
'Configure how often to inject action widgets (e.g., \'Rate App\') into the feed.';
127+
128+
@override
129+
String get adSettingsTitle => 'Advertisement Settings';
130+
131+
@override
132+
String get adSettingsDescription =>
133+
'Manage ad frequency and placement for different user roles.';
134+
135+
@override
136+
String get maintenanceModeTitle => 'Maintenance Mode';
137+
138+
@override
139+
String get maintenanceModeDescription =>
140+
'Enable to show a maintenance screen to all users.';
141+
142+
@override
143+
String get forceUpdateTitle => 'Force App Update';
144+
145+
@override
146+
String get forceUpdateDescription =>
147+
'These settings control app version enforcement. Users on versions below the minimum allowed will be forced to update.';
116148

117149
@override
118150
String get forceUpdateTab => 'Force Update';
@@ -163,10 +195,6 @@ class AppLocalizationsEn extends AppLocalizations {
163195
@override
164196
String get confirmSaveButton => 'Confirm Save';
165197

166-
@override
167-
String get userContentLimitsDescription =>
168-
'These settings define the maximum number of countries, news sources, topics, and saved headlines a user can follow or save. Limits vary by user type (Guest, Standard, Premium) and directly impact what content users can curate.';
169-
170198
@override
171199
String get guestUserTab => 'Guest';
172200

@@ -220,10 +248,6 @@ class AppLocalizationsEn extends AppLocalizations {
220248
String get premiumSavedHeadlinesLimitDescription =>
221249
'Maximum number of headlines a Premium user can save.';
222250

223-
@override
224-
String get adSettingsDescription =>
225-
'These settings control how advertisements are displayed within the app\'s news feed, with different rules for Guest, Standard, and Premium users. \"Ad Frequency\" determines how often an ad can appear, while \"Ad Placement Interval\" sets how many news items must be shown before the very first ad appears.';
226-
227251
@override
228252
String get standardUserAdTab => 'Standard User';
229253

@@ -294,10 +318,6 @@ class AppLocalizationsEn extends AppLocalizations {
294318
String get premiumUserArticlesBeforeInterstitialAdsDescription =>
295319
'Number of articles a Premium user needs to read before a full-screen interstitial ad is shown.';
296320

297-
@override
298-
String get inAppPromptsDescription =>
299-
'These settings control how often special in-app messages or \"prompts\" are shown to users in their news feed. These prompts encourage actions like linking an account (for guests) or upgrading to a premium subscription (for authenticated users). The frequency varies by user type.';
300-
301321
@override
302322
String get appOperationalStatusWarning =>
303323
'WARNING: Changing the app\'s operational status can affect all users. Use with extreme caution.';
@@ -326,10 +346,6 @@ class AppLocalizationsEn extends AppLocalizations {
326346
@override
327347
String get forceUpdateConfigurationTitle => 'Force Update Configuration';
328348

329-
@override
330-
String get forceUpdateDescription =>
331-
'These settings control app version enforcement. Users on versions below the minimum allowed will be forced to update.';
332-
333349
@override
334350
String get minAllowedAppVersionLabel => 'Minimum Allowed App Version';
335351

0 commit comments

Comments
 (0)