Documentation modifications

2026-06-27 15:23:26 -07:00
parent a633fe6c06
commit a19fb90902
218 changed files with 2882 additions and 0 deletions
@@ -22,6 +22,12 @@ public class MasterList
    public LocaleEnum? DefaultLocale { get; set; }
    public List<OptionList> Options { get; set; } = [];

+    /// <summary>
+    /// Returns a copy of this <see cref="MasterList"/> with each option name in <see cref="MasterList.Options"/> localized to the requested <paramref name="localeToReturn"/>, falling back to the original name when no translation is found.
+    /// </summary>
+    /// <param name="localeToReturn">Target <see cref="LocaleEnum"/> used to look up a translated name via reflection on <see cref="OptionList.LocaleItems"/>. When <c>null</c>, the current instance is returned unchanged.</param>
+    /// <returns>A new <see cref="MasterList"/> with localized option names when <paramref name="localeToReturn"/> is provided; otherwise the current instance.</returns>
+    /// <!-- aidoc:v1 sig=803939c body=2054117 -->
    public MasterList ReturnMasterListOptionsInLocaleIfExist(LocaleEnum? localeToReturn)
    {
        if (localeToReturn == null) return this;