Improve naming & documentation

Author: latonv

src/labs/ia-combo-box/ia-combo-box-story.ts

@@ -301,7 +301,7 @@ export class IAComboBoxStory extends LitElement {
   private applySettings(e: Event): void {
     e.preventDefault();
 
-    this.applyOptions();
+    this.updateOptions();
     this.behavior = this.behaviorSelect.value as IAComboBoxBehaviorOption;
     this.label = this.labelInput.value;
     this.placeholder = this.placeholderInput.value;
@@ -317,7 +317,7 @@ export class IAComboBoxStory extends LitElement {
    * Updates which options are shown, depending on the option set chosen and
    * whether custom content should be included.
    */
-  private applyOptions(): void {
+  private updateOptions(): void {
     switch (this.optionSetSelect.value) {
       case 'colors':
         this.options = this.customContentCheck.checked

src/labs/ia-combo-box/ia-combo-box.ts

@@ -152,7 +152,8 @@ export class IAComboBox extends LitElement {
   caseSensitive = false;
 
   /**
-   * Whether the filtered options should be sorted lexicographically before display.
+   * Whether the filtered options should be listed in lexicographically-sorted order.
+   * Default is `false`, displaying them in the same order as the provided options array.
    */
   @property({ type: Boolean, reflect: true }) sort = false;
 
@@ -746,7 +747,8 @@ export class IAComboBox extends LitElement {
   }
 
   /**
-   * Highlights the given option and scrolls it into view if necessary
+   * Highlights the given option and scrolls it into view if necessary.
+   * If `null` is provided, any current highlight will be cleared.
    */
   private async setHighlightedOption(
     option: IAComboBoxOption | null,