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

lib/view/pages/timetable/custom_events/custom_event_edit_dialog.dart

@@ -281,11 +281,8 @@ class _CustomEventEditDialogState extends State<CustomEventEditDialog> {
             ),
           ),
           const Divider(),
-          // The RRuleGenerator widget has zero outer padding while every
-          // surrounding ListTile uses the default 16px horizontal indent.
-          // Wrap it to match — keeps the rule editor visually aligned with
-          // the date/time/color rows above instead of hugging the dialog
-          // border.
+          // RRuleGenerator has zero outer padding; wrap it in the ListTile
+          // default 16px indent so it aligns with the rows above.
           Padding(
             padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 4),
             child: RRuleGenerator(
@@ -309,12 +306,9 @@ class _CustomEventEditDialogState extends State<CustomEventEditDialog> {
     ],
   );
 
-  /// Maps the rrule_generator widget onto Marianum's Material theme so its
-  /// pickers blend in with the rest of the form (the package's defaults
-  /// have an out-of-place red switch outline and bold ALL-CAPS-feeling
-  /// headers). Layout itself stays as the package provides — fully custom
-  /// styling beyond what `RRuleGeneratorConfig` exposes isn't possible
-  /// without forking it.
+  /// Maps the rrule_generator widget onto the app's Material theme so its
+  /// pickers blend in. Styling is limited to what `RRuleGeneratorConfig`
+  /// exposes — fully custom styling isn't possible without forking it.
   RRuleGeneratorConfig _rruleConfig(BuildContext context) {
     final theme = Theme.of(context);
     final cs = theme.colorScheme;