docs: added showSuggestions (#477)

* docs: added showSuggestions

* Update api-configuration.md

* Update api-configuration.md

* Update api-configuration.md

* Update docs/dom-testing-library/api-configuration.md

Co-authored-by: Tim Deschryver <[email protected]>

Co-authored-by: Kent C. Dodds <[email protected]>
Co-authored-by: Tim Deschryver <[email protected]>

Author: 3 people

docs/dom-testing-library/api-configuration.md

@@ -24,6 +24,13 @@ for you to identify the part of your code that resulted in the error (async
 stack traces are hard to debug). If you want to disable this, then set
 `showOriginalStackTrace` to `false`. You can also disable this for a specific
 call in the options you pass to `waitFor`.
+`throwSuggestions`: (experimental) When enabled, if [better queries](https://testing-library.com/docs/guide-which-query) are available 
+the test will fail and provide a suggested query to use instead.  Default to `false`.
+
+To disable a suggestion for a single query just add `{suggest:false}` as an option.
+```js
+screen.getByTestId("foo", {suggest:false}); // will not throw a suggestion
+```
 
 `testIdAttribute`: The attribute used by [`getByTestId`](api-queries#bytestid)
 and related queries. Defaults to `data-testid`.