Improve docs

components/datetime/src/neo.rs

@@ -56,11 +56,17 @@ define_preferences!(
     [Copy]
     DateTimeFormatterPreferences,
     {
-        /// The user's preferred numbering system
+        /// The user's preferred numbering system.
+        ///
+        /// Corresponds to the `-u-nu` in Unicode Locale Identifier.
         numbering_system: NumberingSystem,
-        /// The user's preferred hour cycle
+        /// The user's preferred hour cycle.
+        ///
+        /// Corresponds to the `-u-hc` in Unicode Locale Identifier.
         hour_cycle: HourCycle,
         /// The user's preferred calendar system
+        ///
+        /// Corresponds to the `-u-ca` in Unicode Locale Identifier.
         calendar_algorithm: CalendarAlgorithm
     }
 );

components/decimal/src/lib.rs

@@ -121,7 +121,9 @@ define_preferences!(
     [Copy]
     FixedDecimalFormatterPreferences,
     {
-        /// Numbering System. Corresponds to the `-u-nu` in Unicode Locale Identifier.
+        /// The user's preferred numbering system.
+        ///
+        /// Corresponds to the `-u-nu` in Unicode Locale Identifier.
         numbering_system: NumberingSystem
     }
 );

components/experimental/src/compactdecimal/formatter.rs

@@ -28,7 +28,9 @@ define_preferences!(
     [Copy]
     CompactDecimalFormatterPreferences,
     {
-        /// The numbering system used for formatting.
+        /// The user's preferred numbering system.
+        ///
+        /// Corresponds to the `-u-nu` in Unicode Locale Identifier.
         numbering_system: NumberingSystem
     }
 );

components/experimental/src/dimension/currency/compact_formatter.rs

@@ -29,6 +29,9 @@ define_preferences!(
     [Copy]
     CompactCurrencyFormatterPreferences,
     {
+        /// The user's preferred numbering system.
+        ///
+        /// Corresponds to the `-u-nu` in Unicode Locale Identifier.
         numbering_system: NumberingSystem
     }
 );

components/experimental/src/dimension/currency/formatter.rs

@@ -26,6 +26,9 @@ define_preferences!(
     [Copy]
     CurrencyFormatterPreferences,
     {
+        /// The user's preferred numbering system.
+        ///
+        /// Corresponds to the `-u-nu` in Unicode Locale Identifier.
         numbering_system: NumberingSystem
     }
 );

components/experimental/src/dimension/percent/formatter.rs

@@ -25,6 +25,9 @@ define_preferences!(
     [Copy]
     PercentFormatterPreferences,
     {
+        /// The user's preferred numbering system.
+        ///
+        /// Corresponds to the `-u-nu` in Unicode Locale Identifier.
         numbering_system: NumberingSystem
     }
 );

components/experimental/src/dimension/units/formatter.rs

@@ -26,6 +26,9 @@ define_preferences!(
     [Copy]
     UnitsFormatterPreferences,
     {
+        /// The user's preferred numbering system.
+        ///
+        /// Corresponds to the `-u-nu` in Unicode Locale Identifier.
         numbering_system: NumberingSystem
     }
 );

components/experimental/src/displaynames/displaynames.rs

@@ -17,7 +17,7 @@ use icu_provider::prelude::*;
 use potential_utf::PotentialUtf8;
 
 define_preferences!(
-    /// The preferences for list formatting.
+    /// The preferences for display names.
     [Copy]
     DisplayNamesPreferences,
     {}

components/experimental/src/duration/formatter.rs

@@ -26,6 +26,9 @@ define_preferences!(
     [Copy]
     DurationFormatterPreferences,
     {
+        /// The user's preferred numbering system.
+        ///
+        /// Corresponds to the `-u-nu` in Unicode Locale Identifier.
         numbering_system: NumberingSystem
     }
 );