downshift 7.5.0 → 8.0.0-alpha.0

package/README.md

@@ -70,6 +70,15 @@ to the hook you need by using the links in the list above.
 For examples on how to use the hooks or the Downshift component, check out our
 [docsite][docsite]!
 
+**🚨 Use the Downshift hooks 🚨**
+
+If you are new to the library, consider the _useSelect_ and _useCombobox_ hooks
+as the first option. As mentioned above, the hooks benefit from the updated ARIA
+patterns and are actively maintained and improved. If there are use cases that
+are supported by the _Downshift_ component and not by the hooks, please create
+an issue in our repo. The _Downshift_ component is going to be removed
+completely once the hooks become mature.
+
 ### Downshift
 
 This is a component that controls user interactions and state for you so you can
@@ -747,6 +756,12 @@ Optional properties:
   from `getInputProps` and a `disabled` prop will be returned (effectively
   disabling the input).
 
+- `aria-label`: By default the menu will add an `aria-labelledby` that refers to
+  the `<label>` rendered with `getLabelProps`. However, if you provide
+  `aria-label` to give a more specific label that describes the options
+  available, then `aria-labelledby` will not be provided and screen readers can
+  use your `aria-label` instead.
+
 #### `getLabelProps`
 
 This method should be applied to the `label` you render. It is useful for
@@ -1028,6 +1043,8 @@ const ui = (
 Allows reseting the internal id counter which is used to generate unique ids for
 Downshift component.
 
+**This is unnecessary if you are using React 18 or newer**
+
 You should never need to use this in the browser. Only if you are running an
 universal React app that is rendered on the server you should call
 [resetIdCounter](#resetidcounter) before every render so that the ids that get
@@ -1491,8 +1508,7 @@ MIT
   https://courses.reacttraining.com/courses/advanced-react/lectures/3172720
 [react-training]: https://reacttraining.com/
 [advanced-react]: https://courses.reacttraining.com/courses/enrolled/200086
-[use-a-render-prop]:
-  https://cdb.reacttraining.com/use-a-render-prop-50de598f11ce
+[use-a-render-prop]: https://medium.com/@mjackson/use-a-render-prop-50de598f11ce
 [semver]: http://semver.org/
 [hooks-readme]: https://github.com/downshift-js/downshift/blob/master/src/hooks
 [useselect-readme]: