Merge branch 'master' into refactor/full-docs

Author: omermorad

config/redirects.config.js

@@ -151,5 +151,27 @@ module.exports = {
       to: '/docs/get-started/why-suites',
     },
 
+    // ============================================
+    // GOOGLE SEARCH CONSOLE 404s (Found Nov 2025)
+    // ============================================
+
+    // Old examples page
+    {
+      from: '/docs/overview/examples',
+      to: '/docs/get-started/quickstart',
+    },
+
+    // Extras/identical-injections (old advanced topic)
+    {
+      from: ['/docs/extras/identical-injections', '/docs/extras/identical-injections/'],
+      to: '/docs/guides/adapters/identifiers',
+    },
+
+    // Old category page
+    {
+      from: '/docs/category/di-framework-adapters',
+      to: '/docs/guides/adapters/',
+    },
+
   ],
 };

docs/changelog.md

@@ -48,6 +48,29 @@ Enabled by default. Throws `DependencyNotConfiguredError` on unconfigured depend
 
 See [Fail-Fast Behavior](/docs/api-reference/fail-fast) for details and migration strategies.
 
+### Installation
+
+```bash
+# Core package (beta)
+npm install @suites/unit@beta
+
+# DI adapters (alpha - no boundaries/fail-fast changes)
+npm install @suites/di.nestjs@alpha
+# or
+npm install @suites/di.inversify@alpha
+
+# Doubles adapters (beta)
+npm install @suites/doubles.jest@beta
+# or
+npm install @suites/doubles.vitest@beta
+# or
+npm install @suites/doubles.sinon@beta
+```
+
+:::tip Why Different Versions?
+`@suites/unit` and doubles adapters are on **beta** (boundaries + fail-fast features). DI adapters remain on **alpha** - they're installed separately and don't contain the new testing logic.
+:::
+
 **Breaking Changes:**
 - Node 20+ required (was 16+)
 - InversifyJS v7 required (was v6)

docs/get-started/installation.mdx

@@ -7,38 +7,35 @@ description: Learn how to install and configure Suites to enhance your unit test
 ## Prerequisites
 
 :::warning Node.js Version Requirement
-Suites v4.0.0+ requires **Node.js 20 or higher**.
+Suites v4.0.0+ requires **Node.js 20 or higher**. Check your version with `node --version`.
 :::
 
 - Node.js 20 or higher
 - TypeScript project with decorators enabled
 - A dependency injection framework (NestJS or InversifyJS)
 - A testing library (Jest, Vitest, or Sinon)
 
-## Setup Suites in a New or Existing Project
+## Installation
 
-This section provides instructions for installing Suites and highlights important compatibility and configuration
-details for setting up unit testing with your DI framework.
-
-:::info
-You can find complete setup examples in the [Suites Examples](https://github.com/suites-dev/examples) repository
+:::tip Testing Beta?
+For v4.0.0 beta with boundaries and fail-fast features, see [Changelog](/docs/changelog) for beta installation instructions.
 :::
 
-First, install Suites' main package:
+Install Suites' core package:
 
 ```bash
-$ npm i -D @suites/unit
+npm install -D @suites/unit
 ```
 
-Then, to integrate Suites with your dependency injection framework and preferred testing library, install the corresponding
-adapters for your project.
-
-For example, to use Suites with Jest and NestJS you would run (alongside `@suites/unit` core package):
+Install the adapters for your DI framework and testing library:
 
 ```bash
-$ npm i -D @suites/doubles.jest @suites/di.nestjs
+# Example: Jest + NestJS
+npm install -D @suites/doubles.jest @suites/di.nestjs
 ```
 
+Complete setup examples available in the [Suites Examples](https://github.com/suites-dev/examples) repository.
+
 Lastly, make sure `reflect-metadata` is also installed in your project, not as a dev dependency ([Why?](https://www.typescriptlang.org/docs/handbook/decorators.html#metadata)):
 
 ```bash

netlify.toml

@@ -0,0 +1,61 @@
+[[redirects]]
+from = "/api-reference"
+to = "/docs/get-started"
+status = 301
+
+[[redirects]]
+from = "/docs"
+to = "/docs/get-started"
+status = 301
+
+[[redirects]]
+from = "/docs/getting-started/change-log"
+to = "/docs/migration-guides/from-automock"
+status = 301
+
+# Google Search Console 404s (Nov 2025)
+[[redirects]]
+from = "/docs/overview/examples"
+to = "/docs/get-started/quickstart"
+status = 301
+
+[[redirects]]
+from = "/docs/extras/identical-injections"
+to = "/docs/guides/adapters/identifiers"
+status = 301
+
+[[redirects]]
+from = "/docs/category/di-framework-adapters"
+to = "/docs/guides/adapters"
+status = 301
+
+# High-traffic redirects (from analytics)
+[[redirects]]
+from = "/docs/overview/quickstart"
+to = "/docs/get-started/quickstart"
+status = 301
+
+[[redirects]]
+from = "/docs/overview/installation"
+to = "/docs/get-started/installation"
+status = 301
+
+[[redirects]]
+from = "/docs/developer-guide/unit-tests/suites-api"
+to = "/docs/api-reference"
+status = 301
+
+[[redirects]]
+from = "/docs/developer-guide/unit-tests/solitary"
+to = "/docs/guides/solitary"
+status = 301
+
+[[redirects]]
+from = "/docs/developer-guide/unit-tests/sociable"
+to = "/docs/guides/sociable"
+status = 301
+
+[[redirects]]
+from = "/docs/overview/problems-solved"
+to = "/docs/get-started/why-suites"
+status = 301

src/pages/index.tsx

@@ -346,6 +346,7 @@ export default function Home(): JSX.Element {
           name="description"
           content="Suites automates mocking and simplifies test setup for dependency injection frameworks like NestJS and InversifyJS, reducing boilerplate code."
         />
+        <script defer data-url="https://devhunt.org/tool/suites" src="https://cdn.jsdelivr.net/gh/sidiDev/devhunt-banner/indexV0.js"></script>
       </Head>
       <HomepageHeader />
     </Layout>