Update docs site link and tweak content

src/autotrackMemoize/autotrackMemoize.ts

@@ -62,7 +62,7 @@ import { createCache } from './autotracking'
  *
  * @template Func - The type of the function that is memoized.
  *
- * @see {@link https://reselect-docs.netlify.app/api/unstable_autotrackMemoize autotrackMemoize}
+ * @see {@link https://reselect.js.org/api/unstable_autotrackMemoize autotrackMemoize}
  *
  * @since 5.0.0
  * @public

src/createSelectorCreator.ts

@@ -170,7 +170,7 @@ export interface CreateSelectorFunction<
  * @template MemoizeFunction - The type of the memoize function that is used to memoize the `resultFunc` inside `createSelector` (e.g., `lruMemoize` or `weakMapMemoize`).
  * @template ArgsMemoizeFunction - The type of the optional memoize function that is used to memoize the arguments passed into the output selector generated by `createSelector` (e.g., `lruMemoize` or `weakMapMemoize`). If none is explicitly provided, `weakMapMemoize` will be used.
  *
- * @see {@link https://reselect-docs.netlify.app/api/createSelectorCreator#using-options-since-500 `createSelectorCreator`}
+ * @see {@link https://reselect.js.org/api/createSelectorCreator#using-options-since-500 `createSelectorCreator`}
  *
  * @since 5.0.0
  * @public
@@ -216,7 +216,7 @@ export function createSelectorCreator<
  *
  * @template MemoizeFunction - The type of the memoize function that is used to memoize the `resultFunc` inside `createSelector` (e.g., `lruMemoize` or `weakMapMemoize`).
  *
- * @see {@link https://reselect-docs.netlify.app/api/createSelectorCreator#using-memoize-and-memoizeoptions `createSelectorCreator`}
+ * @see {@link https://reselect.js.org/api/createSelectorCreator#using-memoize-and-memoizeoptions `createSelectorCreator`}
  *
  * @public
  */
@@ -435,7 +435,7 @@ export function createSelectorCreator<
  * a single "result function" / "combiner", and an optional options object, and
  * generates a memoized selector function.
  *
- * @see {@link https://reselect-docs.netlify.app/api/createSelector `createSelector`}
+ * @see {@link https://reselect.js.org/api/createSelector `createSelector`}
  *
  * @public
  */

src/createStructuredSelector.ts

@@ -61,7 +61,7 @@ interface SelectorsObject {
  * The structured selector can take multiple input selectors
  * and map their output to an object with specific keys.
  *
- * @see {@link https://reselect-docs.netlify.app/api/createStructuredSelector `createStructuredSelector`}
+ * @see {@link https://reselect.js.org/api/createStructuredSelector `createStructuredSelector`}
  *
  * @public
  */
@@ -136,7 +136,7 @@ export interface StructuredSelectorCreator {
    * @template MemoizeFunction - The type of the memoize function that is used to create the structured selector. It defaults to `weakMapMemoize`.
    * @template ArgsMemoizeFunction - The type of the of the memoize function that is used to memoize the arguments passed into the generated structured selector. It defaults to `weakMapMemoize`.
    *
-   * @see {@link https://reselect-docs.netlify.app/api/createStructuredSelector `createStructuredSelector`}
+   * @see {@link https://reselect.js.org/api/createStructuredSelector `createStructuredSelector`}
    */
   <
     InputSelectorsObject extends SelectorsObject,
@@ -203,7 +203,7 @@ export interface StructuredSelectorCreator {
  * )
  * ```
  *
- * @see {@link https://reselect-docs.netlify.app/api/createStructuredSelector `createStructuredSelector`}
+ * @see {@link https://reselect.js.org/api/createStructuredSelector `createStructuredSelector`}
  *
  * @public
  */

src/devModeChecks/identityFunctionCheck.ts

@@ -10,7 +10,7 @@ import type { AnyFunction } from '../types'
  *
  * @param resultFunc - The result function to be checked.
  *
- * @see {@link https://reselect-docs.netlify.app/api/development-only-stability-checks#identityfunctioncheck `identityFunctionCheck`}
+ * @see {@link https://reselect.js.org/api/development-only-stability-checks#identityfunctioncheck `identityFunctionCheck`}
  *
  * @since 5.0.0
  * @internal

src/devModeChecks/inputStabilityCheck.ts

@@ -9,7 +9,7 @@ import type { CreateSelectorOptions, UnknownMemoizer } from '../types'
  * @param options - Options object consisting of a `memoize` function and a `memoizeOptions` object.
  * @param inputSelectorArgs - List of arguments being passed to the input selectors.
  *
- * @see {@link https://reselect-docs.netlify.app/api/development-only-stability-checks/#inputstabilitycheck `inputStabilityCheck`}
+ * @see {@link https://reselect.js.org/api/development-only-stability-checks/#inputstabilitycheck `inputStabilityCheck`}
  *
  * @since 5.0.0
  * @internal

src/devModeChecks/setGlobalDevModeChecks.ts

@@ -50,8 +50,8 @@ export const globalDevModeChecks: DevModeChecks = {
  * // Never run the identity function check.
  * setGlobalDevModeChecks({ identityFunctionCheck: 'never' })
  * ```
- * @see {@link https://reselect-docs.netlify.app/api/development-only-stability-checks Development-Only Stability Checks}
- * @see {@link https://reselect-docs.netlify.app/api/development-only-stability-checks#1-globally-through-setglobaldevmodechecks global-configuration}
+ * @see {@link https://reselect.js.org/api/development-only-stability-checks Development-Only Stability Checks}
+ * @see {@link https://reselect.js.org/api/development-only-stability-checks#1-globally-through-setglobaldevmodechecks global-configuration}
  *
  * @since 5.0.0
  * @public

src/lruMemoize.ts

@@ -181,7 +181,7 @@ export interface LruMemoizeOptions<Result = any> {
  *
  * @template Func - The type of the function that is memoized.
  *
- * @see {@link https://reselect-docs.netlify.app/api/lruMemoize `lruMemoize`}
+ * @see {@link https://reselect.js.org/api/lruMemoize `lruMemoize`}
  *
  * @public
  */

src/types.ts

@@ -72,7 +72,7 @@ export interface CreateSelectorOptions<
    * and warn about potential issues in selector behavior. This option
    * allows you to customize the behavior of these checks per selector.
    *
-   * @see {@link https://reselect-docs.netlify.app/api/development-only-stability-checks Development-Only Stability Checks}
+   * @see {@link https://reselect.js.org/api/development-only-stability-checks Development-Only Stability Checks}
    *
    * @since 5.0.0
    */
@@ -315,9 +315,9 @@ export interface DevModeChecks {
    *
    * @default 'once'
    *
-   * @see {@link https://reselect-docs.netlify.app/api/development-only-stability-checks Development-Only Stability Checks}
-   * @see {@link https://reselect-docs.netlify.app/api/development-only-stability-checks#inputstabilitycheck `inputStabilityCheck`}
-   * @see {@link https://reselect-docs.netlify.app/api/development-only-stability-checks#2-per-selector-by-passing-an-inputstabilitycheck-option-directly-to- per-selector-configuration}
+   * @see {@link https://reselect.js.org/api/development-only-stability-checks Development-Only Stability Checks}
+   * @see {@link https://reselect.js.org/api/development-only-stability-checks#inputstabilitycheck `inputStabilityCheck`}
+   * @see {@link https://reselect.js.org/api/development-only-stability-checks#2-per-selector-by-passing-an-inputstabilitycheck-option-directly-to- per-selector-configuration}
    *
    * @since 5.0.0
    */
@@ -331,9 +331,9 @@ export interface DevModeChecks {
    *
    * @default 'once'
    *
-   * @see {@link https://reselect-docs.netlify.app/api/development-only-stability-checks Development-Only Stability Checks}
-   * @see {@link https://reselect-docs.netlify.app/api/development-only-stability-checks#identityfunctioncheck `identityFunctionCheck`}
-   * @see {@link https://reselect-docs.netlify.app/api/development-only-stability-checks#2-per-selector-by-passing-an-identityfunctioncheck-option-directly-to- per-selector-configuration}
+   * @see {@link https://reselect.js.org/api/development-only-stability-checks Development-Only Stability Checks}
+   * @see {@link https://reselect.js.org/api/development-only-stability-checks#identityfunctioncheck `identityFunctionCheck`}
+   * @see {@link https://reselect.js.org/api/development-only-stability-checks#2-per-selector-by-passing-an-identityfunctioncheck-option-directly-to- per-selector-configuration}
    *
    * @since 5.0.0
    */

src/weakMapMemoize.ts

@@ -160,7 +160,7 @@ export interface WeakMapMemoizeOptions<Result = any> {
  *
  * @template Func - The type of the function that is memoized.
  *
- * @see {@link https://reselect-docs.netlify.app/api/weakMapMemoize `weakMapMemoize`}
+ * @see {@link https://reselect.js.org/api/weakMapMemoize `weakMapMemoize`}
  *
  * @since 5.0.0
  * @public

website/docs/api/createSelector.mdx

@@ -14,6 +14,22 @@ Accepts one or more "<InternalLinks.InputSelectors />" (either as separate argum
 a single "<InternalLinks.ResultFunction />", and an optional options object, and
 generates a memoized selector function.
 
+The **Redux docs usage page on [Deriving Data with Selectors](https://redux.js.org/usage/deriving-data-selectors)** covers the purpose and motivation for selectors, why memoized selectors are useful, and typical Reselect usage patterns.
+
+```ts no-emit
+const selectTodosByCategory = createSelector(
+  [
+    // Pass input selectors with typed arguments
+    (state: RootState) => state.todos,
+    (state: RootState, category: string) => category
+  ],
+  // Extracted values are passed to the result function for recalculation
+  (todos, category) => {
+    return todos.filter(t => t.category === category)
+  }
+)
+```
+
 ## Parameters
 
 | Name                     | Description                                                                                      |

website/docs/introduction/how-does-reselect-work.mdx

@@ -50,7 +50,7 @@ The way Reselect works can be broken down into multiple parts:
      - If the results are the same, it returns the cached result without running the <InternalLinks.ResultFunction />.
      - If the results differ, it runs the <InternalLinks.ResultFunction />.
 
-This behavior is what we call **_Cascading Double-Layer Memoization_**.
+This behavior is what we call **_Cascading Memoization_**.
 
 ### Reselect Vs Standard Memoization
 
@@ -135,6 +135,6 @@ store.dispatch(toggleRead(0))
 selectCompletedTodos(store.getState())
 ```
 
-Even when the overall `state` changes, Reselect ensures efficient memoization through its unique approach. The <InternalLinks.ResultFunction /> doesn't re-run if the relevant part of the `state` (in this case `state.todos`), remains unchanged. This is due to Reselect's <InternalLinks.CascadingMemoization text="Cascading Double-Layer Memoization" />. The first layer checks the entire `state`, and the second layer checks the results of the <InternalLinks.InputSelectors />. If the first layer fails (due to a change in the overall `state`) but the second layer succeeds (because `state.todos` is unchanged), Reselect skips recalculating the <InternalLinks.ResultFunction />. This dual-check mechanism makes Reselect particularly effective in <ExternalLinks.Redux /> applications, ensuring computations are only done when truly necessary.
+Even when the overall `state` changes, Reselect ensures efficient memoization through its unique approach. The <InternalLinks.ResultFunction /> doesn't re-run if the relevant part of the `state` (in this case `state.todos`), remains unchanged. This is due to Reselect's <InternalLinks.CascadingMemoization text="Cascading Memoization" />. The first layer checks the entire `state`, and the second layer checks the results of the <InternalLinks.InputSelectors />. If the first layer fails (due to a change in the overall `state`) but the second layer succeeds (because `state.todos` is unchanged), Reselect skips recalculating the <InternalLinks.ResultFunction />. This dual-check mechanism makes Reselect particularly effective in <ExternalLinks.Redux /> applications, ensuring computations are only done when truly necessary.
 
 ---

website/src/components/InternalLinks.tsx

@@ -49,9 +49,7 @@ export const InternalLinks = {
       to="/introduction/how-does-reselect-work#cascading-memoization"
       title="Cascading Memoization"
     >
-      <b>
-        <i>{text}</i>
-      </b>
+      "{text}"
     </Link>
   )),
   OutputSelectorFields: memo(({ text = 'Output Selector Fields' }) => (