docs(:memo:) updating docs

- Using correct search key
- Adding info on using `checked`
- Adding gotchas for indeterminates

Author: atomicpages

docs/docs/checkbox.md

@@ -256,3 +256,32 @@ Controlled indeterminates have a whole host of usages including trees!
     return App;
 })()
 ```
+
+### `indeterminate` Gotchas
+
+No pun intended :laughing:. Okay, but seriously there's one gotcha regarding `indeterminate` prop usage you need to be aware of. In rare cases usage of the `indeterminate` prop with `checked` will result in the checkbox becoming immediately checked after React re-renders the component. Be sure `indeterminate` is `undefined`:
+
+```jsx {3}
+<Checkbox
+    checked={checked}
+    indeterminate={indeterminate || undefined}
+    onChange={/* ... */}
+    icon={/* ... */} />
+```
+
+This is due to a side effect in `useIndeterminate.ts` and in particular the three highlighted lines below:
+
+```js {3,5,7}
+React.useEffect(() => {
+    if (
+        state !== 'indeterminate' &&
+        ref.current &&
+        typeof indeterminateFromProps !== 'undefined'
+    ) {
+        ref.current.checked = indeterminateFromProps;
+        setStatus(indeterminateFromProps);
+    }
+}, [indeterminateFromProps, state]);
+```
+
+If `indeterminateFromProps` is `false` (not `undefined`) then our checkbox becomes immediately unchecked :cry:.

docs/docs/main-concepts/controlled.md

@@ -156,3 +156,23 @@ class App extends React.Component {
     }
 }
 ```
+
+### Using `checked`
+
+For ultra fine-grained control you can use the `checked` prop to _completely_ control the input:
+
+```jsx live
+function App() {
+    const [checked, setChecked] = React.useState(false);
+
+    const onChange = React.useCallback(() => {
+        setChecked(prev => !prev);
+    }, []);
+
+    return (
+        <Checkbox checked={checked} onChange={onChange}>
+            Checked: {checked + ''}
+        </Checkbox>
+    );
+}
+```

docs/docusaurus.config.js

@@ -143,7 +143,7 @@ module.exports = {
         },
         algolia: {
             apiKey: process.env.ALGOLIA_KEY,
-            indexName: 'pretty-checkbox',
+            indexName: 'pretty-checkbox-react',
             searchParameters: {}, // Optional (if provided by Algolia)
         },
     },

docs/package.json

@@ -38,8 +38,8 @@
     },
     "devDependencies": {
         "@djthoms/docusaurus-plugin-sass": "^0.2.0",
-        "@docusaurus/module-type-aliases": "^2.0.0-alpha.64",
-        "docusaurus-plugin-module-alias": "^0.0.1",
+        "@docusaurus/module-type-aliases": "^2.0.0-alpha.68",
+        "docusaurus-plugin-module-alias": "^0.0.2",
         "docusaurus-plugin-react-docgen-typescript": "^0.0.1",
         "react-docgen-typescript": "^1.20.4",
         "sass": "^1.26.10",