…2299)

* first pass at docs

* add jump-to-section

* Update deprecation comments

* Update testing guide

* WIP

* Minor fixes

* WIP

* Update docs/guides/ssr-and-hygration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update docs/guides/ssr-and-hygration.md

Co-authored-by: Blazej Sewera <[email protected]>

* WIP

* Minor changes

* Minor changes

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update ssr-and-hygration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update ssr-and-hygration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update ssr-and-hygration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update ssr-and-hygration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update ssr-and-hygration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update ssr-and-hygration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update ssr-and-hygration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update ssr-and-hygration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update ssr-and-hygration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update docs/guides/nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update docs/guides/ssr-and-hygration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update docs/guides/nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Minor fixes

* Update docs/guides/nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update docs/guides/nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update docs/guides/ssr-and-hydration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update docs/guides/ssr-and-hydration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update docs/guides/ssr-and-hydration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update docs/guides/ssr-and-hydration.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update docs/guides/nextjs.md

Co-authored-by: Blazej Sewera <[email protected]>

* Update docs/guides/nextjs.md

Co-authored-by: Charles Kornoelje <[email protected]>

* Update docs/guides/ssr-and-hydration.md

Co-authored-by: Charles Kornoelje <[email protected]>

* Update ssr-and-hydration.md

* Update docs/guides/ssr-and-hydration.md

Co-authored-by: Charles Kornoelje <[email protected]>

---------

Co-authored-by: Blazej Sewera <[email protected]>
Co-authored-by: Charles Kornoelje <[email protected]>

* docs(middleware): modify `set` and `setState`

* update middleware docs

* Update nextjs guide

* Minor changes

* Minor changes

* Minor changes

* Minor changes

* Minor changes

* Minor changes

Right now, we're requiring new `StateStorage` implementations to forcefully return `void` from inside `setItem` and `removeItem`.

When using a library that returns the set value for `setItem` or `removeItem`, therefore returning  a `string`, it causes Typescript to fail, requiring some weird workarounds.

For example, when using `localforage` (https://github.com/localForage/localForage) one needs to do what we describe below. Notice the `void` keyword.

```typescript
const storage: StateStorage = {
   ...localForage,
   setItem: void localForage.setItem.bind(localForage)
}
```

Another, longer, alternative is

```typescript
const storage: StateStorage = {
   ...localForage,
   // Curly braces are required because we need to "return `void`"
   setItem: (name, value) => {
       localStorage.setItem(name, value)
  }
}
```

By changing the type implementation to ignore types - using unknown - we can simply use `localforage` - and similar libraries - as if we were using `window.localStorage`