ComboBox, Dropdown, TextField doc updates

change/office-ui-fabric-react-2020-09-17-12-42-26-docs-update-2.json

@@ -0,0 +1,8 @@
+{
+  "type": "patch",
+  "comment": "Update website content for ComboBox, Dropdown, and TextField",
+  "packageName": "office-ui-fabric-react",
+  "email": "[email protected]",
+  "dependentChangeType": "patch",
+  "date": "2020-09-17T19:42:26.105Z"
+}

packages/office-ui-fabric-react/src/components/ComboBox/docs/ComboBoxOverview.md

@@ -1 +1 @@
-A combo box (`ComboBox`) combines a text field and a drop-down menu, giving people a way to select an option from a list or enter their own choice.
+A combo box (`ComboBox`) combines a text field and a dropdown giving people a way to select an option from a list or enter their own choice.

packages/office-ui-fabric-react/src/components/Dropdown/docs/DropdownBestPractices.md

@@ -1,12 +1,12 @@
 ### Layout
 
-- Use a dropdown list when there are multiple choices that can be collapsed under one title, if the list of items is too long, or when space is constrained.
-- Use a dropdown list when the selected option is more important than the alternatives (in contrast to radio buttons where all the choices are visible, putting equal emphasis on all options).
+- Use a dropdown when there are multiple choices that can be collapsed under one title, if the list of items is too long, or when space is constrained.
+- Use a dropdown when the selected option is more important than the alternatives (in contrast to radio buttons where all the choices are visible, putting equal emphasis on all options).
 
 ### Content
 
 - Use sentence-style capitalization—only capitalize the first word. For more info, see [Capitalization](https://docs.microsoft.com/style-guide/capitalization) in the Microsoft Writing Style Guide.
-- The dropdown list label should describe what can be found in the menu.
+- The dropdown label should describe what can be found in the list of options.
 - Use shortened statements or single words as list options.
 - If there isn't a default option, use "Select an option" as placeholder text.
 - If "None" is an option, include it.

packages/office-ui-fabric-react/src/components/Dropdown/docs/DropdownOverview.md

@@ -1 +1 @@
-A dropdown menu is a list in which the selected item is always visible while other items are visible on demand by clicking a dropdown button.
+A dropdown is a list in which the selected item is always visible while other items are visible on demand by clicking a dropdown button. Dropdowns are typically used for forms. 

packages/office-ui-fabric-react/src/components/TextField/docs/TextFieldBestPractices.md

@@ -7,5 +7,5 @@
 ### Content
 
 - Include a short label above the text field to communicate what information should be entered. Don't use placeholder text instead of a label. Placeholder text poses a variety of accessibility issues (including possible problems with color/contrast, and people thinking the form input is already filled out).
-- When part of a form, make it clear which fields are required vs. optional. If the input is required, add "(required)" to the label. Don't exclusively use "\*" to indicate required inputs as it is often not read by screen readers. For example, "First name (required)".
+- When part of a form, make it clear which fields are required vs. optional. If the input is required, add an asterisk "\*" to the label. For screen readers, make sure the `aria-required` property is set to `true`.
 - Use sentence-style capitalization—only capitalize the first word. For more info, see [Capitalization](https://docs.microsoft.com/style-guide/capitalization) in the Microsoft Writing Style Guide.