feat: Add docs for defaultHidden config (testing-library#306)

Author: eps1lon

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

@@ -15,8 +15,11 @@ The library can be configured via the `configure` function, which accepts:
 
 Configuration options:
 
-`testIdAttribute`: The attribute used by `getByTestId` and related queries.
-Defaults to `data-testid`. See [`getByTestId`](#getbytestid).
+`defaultHidden`: The default value for the `hidden` option used by
+[`getByRole`](api-queries#byrole). Defaults to `false`.
+
+`testIdAttribute`: The attribute used by [`getByTestId`](api-queries#bytestid)
+and related queries. Defaults to `data-testid`.
 
 <!--DOCUSAURUS_CODE_TABS-->
 

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

@@ -533,7 +533,7 @@ getByRole(
   role: TextMatch,
   options?: {
     exact?: boolean = true,
-    hidden?: boolean = false,
+    hidden?: boolean = true,
     normalizer?: NormalizerFn,
   }): HTMLElement
 ```
@@ -569,6 +569,8 @@ case. For example in
 assertions about the `Open dialog`-button you would need to use
 `getAllByRole('button', { hidden: true })`.
 
+The default value can [be configured](api-configuration#configuration).
+
 ```html
 <div role="dialog">...</div>
 ```