From ea72640956018cf195b9c6fdbce2a95c7d5781f9 Mon Sep 17 00:00:00 2001
From: tobias-tengler <45513122+tobias-tengler@users.noreply.github.com>
Date: Fri, 12 Jun 2026 20:54:06 +0200
Subject: [PATCH] Add missing documentation redirects

---
 website-next/nginx/conf.d/redirects.conf | 186 +++++++++++++++++------
 1 file changed, 142 insertions(+), 44 deletions(-)

diff --git a/website-next/nginx/conf.d/redirects.conf b/website-next/nginx/conf.d/redirects.conf
index 7cae629010d..ee21e069f1f 100644
--- a/website-next/nginx/conf.d/redirects.conf
+++ b/website-next/nginx/conf.d/redirects.conf
@@ -22,7 +22,7 @@ rewrite ^/products/bananacakepop/?$ /products/nitro permanent;
 rewrite "^/blog/(\d{4})/(\d{2})/(\d{2})/(.+?)/?$" /blog/$1-$2-$3-$4 permanent;
 
 # greendonut -> hotchocolate
-rewrite ^/docs/greendonut.*$ /docs/hotchocolate/fetching-data/dataloader permanent;
+rewrite ^/docs/greendonut.*$ /docs/hotchocolate/fetching-data/batching/dataloader permanent;
 
 # marshmallowpie -> hotchocolate
 rewrite ^/docs/marshmallowpie.*$ /docs/hotchocolate permanent;
@@ -31,103 +31,201 @@ rewrite ^/docs/marshmallowpie.*$ /docs/hotchocolate permanent;
 rewrite ^/docs/bananacakepop/v2/apis/open-telemetry/?$ /docs/nitro/open-telemetry/operation-monitoring permanent;
 
 # get-started -> get-started-with-graphql-in-net-core
-rewrite ^/docs/hotchocolate/(v12|v13)/get-started/?$ /docs/hotchocolate/get-started-with-graphql-in-net-core permanent;
+rewrite ^/docs/hotchocolate/(v11|v12|v13)/get-started/?$ /docs/hotchocolate/get-started-with-graphql-in-net-core permanent;
 
-# performance/persisted-queries -> performance/persisted-operations
-rewrite ^/docs/hotchocolate/(v13|v14)/performance/persisted-queries/?$ /docs/hotchocolate/performance/persisted-operations permanent;
+# performance/persisted-queries -> performance/trusted-documents
+rewrite ^/docs/hotchocolate/(v11|v12|v13|v14)/performance/persisted-queries/?$ /docs/hotchocolate/performance/trusted-documents permanent;
+
+# performance/persisted-operations -> performance/trusted-documents
+rewrite ^/docs/hotchocolate/(v14|v15)/performance/persisted-operations/?$ /docs/hotchocolate/performance/trusted-documents permanent;
+
+# performance/automatic-persisted-queries -> performance/automatic-persisted-operations
+rewrite ^/docs/hotchocolate/(v11|v12|v13)/performance/automatic-persisted-queries/?$ /docs/hotchocolate/performance/automatic-persisted-operations permanent;
 
 # code-first|schema|schema-first -> defining-a-schema
-rewrite ^/docs/hotchocolate/(v12|v13)/(code-first|schema|schema-first)/?$ /docs/hotchocolate/defining-a-schema permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/(code-first|schema|schema-first)/?$ /docs/hotchocolate/defining-a-schema permanent;
 
 # schema/custom-scalar-types -> defining-a-schema/scalars
-rewrite ^/docs/hotchocolate/(v12|v13)/schema/custom-scalar-types/?$ /docs/hotchocolate/defining-a-schema/scalars permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/schema/custom-scalar-types/?$ /docs/hotchocolate/defining-a-schema/scalars permanent;
 
 # schema/descriptions -> defining-a-schema/documentation
-rewrite ^/docs/hotchocolate/(v12|v13)/schema/descriptions/?$ /docs/hotchocolate/defining-a-schema/documentation permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/schema/descriptions/?$ /docs/hotchocolate/defining-a-schema/documentation permanent;
 
 # schema/directives -> defining-a-schema/directives
-rewrite ^/docs/hotchocolate/(v12|v13)/schema/directives/?$ /docs/hotchocolate/defining-a-schema/directives permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/schema/directives/?$ /docs/hotchocolate/defining-a-schema/directives permanent;
 
 # schema/enum-type -> defining-a-schema/enums
-rewrite ^/docs/hotchocolate/(v12|v13)/schema/enum-type/?$ /docs/hotchocolate/defining-a-schema/enums permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/schema/enum-type/?$ /docs/hotchocolate/defining-a-schema/enums permanent;
 
 # schema/input-object-type -> defining-a-schema/input-object-types
-rewrite ^/docs/hotchocolate/(v12|v13)/schema/input-object-type/?$ /docs/hotchocolate/defining-a-schema/input-object-types permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/schema/input-object-type/?$ /docs/hotchocolate/defining-a-schema/input-object-types permanent;
 
 # schema/interface-type -> defining-a-schema/interfaces
-rewrite ^/docs/hotchocolate/(v12|v13)/schema/interface-type/?$ /docs/hotchocolate/defining-a-schema/interfaces permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/schema/interface-type/?$ /docs/hotchocolate/defining-a-schema/interfaces permanent;
 
-# schema/object-type -> defining-a-schema/object-types
-rewrite ^/docs/hotchocolate/(v12|v13)/schema/object-type/?$ /docs/hotchocolate/defining-a-schema/object-types permanent;
+# schema/object-type|code-first-object-type|extending-types -> defining-a-schema/object-types
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/schema/object-type/?$ /docs/hotchocolate/defining-a-schema/object-types permanent;
+rewrite ^/docs/hotchocolate/v10/schema/(code-first-object-type|extending-types)/?$ /docs/hotchocolate/defining-a-schema/object-types permanent;
+
+# schema/options -> server/options
+rewrite ^/docs/hotchocolate/v10/schema/options/?$ /docs/hotchocolate/server/options permanent;
 
 # schema/relay -> defining-a-schema/relay
-rewrite ^/docs/hotchocolate/(v12|v13)/schema/relay/?$ /docs/hotchocolate/defining-a-schema/relay permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/schema/relay/?$ /docs/hotchocolate/defining-a-schema/relay permanent;
 
-# schema/resolvers -> fetching-data/resolvers
-rewrite ^/docs/hotchocolate/(v12|v13)/schema/resolvers/?$ /docs/hotchocolate/fetching-data/resolvers permanent;
+# schema/resolvers -> resolvers
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/schema/resolvers/?$ /docs/hotchocolate/resolvers permanent;
 
 # schema/union-type -> defining-a-schema/unions
-rewrite ^/docs/hotchocolate/(v12|v13)/schema/union-type/?$ /docs/hotchocolate/defining-a-schema/unions permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/schema/union-type/?$ /docs/hotchocolate/defining-a-schema/unions permanent;
 
-# data-fetching -> fetching-data/dataloader
-rewrite ^/docs/hotchocolate/(v12|v13)/data-fetching/?$ /docs/hotchocolate/fetching-data/dataloader permanent;
+# data-fetching -> fetching-data/batching/dataloader
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/data-fetching/?$ /docs/hotchocolate/fetching-data/batching/dataloader permanent;
 
 # data-fetching/pagination -> fetching-data/pagination
-rewrite ^/docs/hotchocolate/(v12|v13)/data-fetching/pagination/?$ /docs/hotchocolate/fetching-data/pagination permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/data-fetching/pagination/?$ /docs/hotchocolate/fetching-data/pagination permanent;
 
 # data-fetching/filters -> fetching-data/filtering
-rewrite ^/docs/hotchocolate/(v12|v13)/data-fetching/filters/?$ /docs/hotchocolate/fetching-data/filtering permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/data-fetching/filters/?$ /docs/hotchocolate/fetching-data/filtering permanent;
+
+# execution-engine -> resolvers/field-middleware
+rewrite ^/docs/hotchocolate/(v12|v13)/execution-engine/?$ /docs/hotchocolate/resolvers/field-middleware permanent;
 
-# execution-engine -> performance/persisted-queries
-rewrite ^/docs/hotchocolate/(v12|v13)/execution-engine/?$ /docs/hotchocolate/performance/persisted-queries permanent;
+# execution-engine/apollo-tracing -> server/instrumentation
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/execution-engine/apollo-tracing/?$ /docs/hotchocolate/server/instrumentation permanent;
 
-# execution-engine/apollo-tracing -> server/instrumentation#apollo-tracing
-rewrite ^/docs/hotchocolate/(v12|v13)/execution-engine/apollo-tracing/?$ /docs/hotchocolate/server/instrumentation#apollo-tracing permanent;
+# execution-engine/batching -> server/batching
+rewrite ^/docs/hotchocolate/v10/execution-engine/batching/?$ /docs/hotchocolate/server/batching permanent;
 
-# execution-engine/custom-context-data -> execution-engine
-rewrite ^/docs/hotchocolate/(v12|v13)/execution-engine/custom-context-data/?$ /docs/hotchocolate/execution-engine permanent;
+# execution-engine/custom-context-data -> server/global-state
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/execution-engine/custom-context-data/?$ /docs/hotchocolate/server/global-state permanent;
+
+# execution-engine/error-filter -> resolvers/errors
+rewrite ^/docs/hotchocolate/v10/execution-engine/error-filter/?$ /docs/hotchocolate/resolvers/errors permanent;
+
+# execution-engine/execution-options -> server/options
+rewrite ^/docs/hotchocolate/v10/execution-engine/execution-options/?$ /docs/hotchocolate/server/options permanent;
+
+# execution-engine/field-middleware -> resolvers/field-middleware
+rewrite ^/docs/hotchocolate/(v12|v13|v14|v15)/execution-engine/field-middleware/?$ /docs/hotchocolate/resolvers/field-middleware permanent;
 
 # execution-engine/instrumentation -> server/instrumentation
-rewrite ^/docs/hotchocolate/(v12|v13)/execution-engine/instrumentation/?$ /docs/hotchocolate/server/instrumentation permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/execution-engine/instrumentation/?$ /docs/hotchocolate/server/instrumentation permanent;
 
-# execution-engine/persisted-queries -> performance/persisted-queries
-rewrite ^/docs/hotchocolate/(v12|v13)/execution-engine/persisted-queries/?$ /docs/hotchocolate/performance/persisted-queries permanent;
+# execution-engine/persisted-queries -> performance/trusted-documents
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/execution-engine/persisted-queries/?$ /docs/hotchocolate/performance/trusted-documents permanent;
 
 # execution-engine/subscriptions -> defining-a-schema/subscriptions
-rewrite ^/docs/hotchocolate/(v12|v13)/execution-engine/subscriptions/?$ /docs/hotchocolate/defining-a-schema/subscriptions permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/execution-engine/subscriptions/?$ /docs/hotchocolate/defining-a-schema/subscriptions permanent;
 
 # execution-engine/type-conversion -> defining-a-schema/scalars#custom-converters
-rewrite ^/docs/hotchocolate/(v12|v13)/execution-engine/type-conversion/?$ /docs/hotchocolate/defining-a-schema/scalars#custom-converters permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/execution-engine/type-conversion/?$ /docs/hotchocolate/defining-a-schema/scalars#custom-converters permanent;
 
 # security/security -> security
-rewrite ^/docs/hotchocolate/(v12|v13)/security/security/?$ /docs/hotchocolate/security permanent;
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/security/security/?$ /docs/hotchocolate/security permanent;
+
+# security/operation-complexity -> security/cost-analysis
+rewrite ^/docs/hotchocolate/(v12|v13)/security/operation-complexity/?$ /docs/hotchocolate/security/cost-analysis permanent;
 
-# stitching -> distributed-schema
-rewrite ^/docs/hotchocolate/(v12|v13)/stitching/?$ /docs/hotchocolate/distributed-schema permanent;
+# security/query-depth -> security/request-limits#execution-depth
+rewrite ^/docs/hotchocolate/(v12|v13|v14|v15)/security/query-depth/?$ /docs/hotchocolate/security/request-limits#execution-depth permanent;
 
-# tutorials -> integrations/entity-framework
-rewrite ^/docs/hotchocolate/(v12|v13)/tutorials/?$ /docs/hotchocolate/integrations/entity-framework permanent;
+# stitching -> fusion/migration/migrating-from-schema-stitching
+rewrite ^/docs/hotchocolate/(v12|v13)/stitching/?$ /docs/fusion/migration/migrating-from-schema-stitching permanent;
+
+# tutorials -> fetching-data/integrations/entity-framework
+rewrite ^/docs/hotchocolate/(v10|v12|v13)/tutorials/?$ /docs/hotchocolate/fetching-data/integrations/entity-framework permanent;
 
 # api-reference/aspnetcore -> server
-rewrite ^/docs/hotchocolate/(v13)/api-reference/aspnetcore/?$ /docs/hotchocolate/server permanent;
+rewrite ^/docs/hotchocolate/(v11|v12|v13)/api-reference/aspnetcore/?$ /docs/hotchocolate/server permanent;
+
+# api-reference/apollo-tracing -> server/instrumentation
+rewrite ^/docs/hotchocolate/(v11)/api-reference/apollo-tracing/?$ /docs/hotchocolate/server/instrumentation permanent;
+
+# api-reference/custom-context-data -> server/global-state
+rewrite ^/docs/hotchocolate/(v11|v12|v13|v14|v15)/api-reference/custom-context-data/?$ /docs/hotchocolate/server/global-state permanent;
+
+# api-reference/dependency-injection -> resolvers/dependency-injection
+rewrite ^/docs/hotchocolate/(v11)/api-reference/dependency-injection/?$ /docs/hotchocolate/resolvers/dependency-injection permanent;
+
+# api-reference/error-filter|errors -> resolvers/errors
+rewrite ^/docs/hotchocolate/(v11|v12|v13|v14|v15)/api-reference/(error-filter|errors)/?$ /docs/hotchocolate/resolvers/errors permanent;
+
+# api-reference/executable -> fetching-data/integrations
+rewrite ^/docs/hotchocolate/(v11|v12|v13|v14|v15)/api-reference/executable/?$ /docs/hotchocolate/fetching-data/integrations permanent;
+
+# api-reference/extending-filtering -> fetching-data/integrations/extending-filtering
+rewrite ^/docs/hotchocolate/(v11|v12|v13|v14|v15)/api-reference/extending-filtering/?$ /docs/hotchocolate/fetching-data/integrations/extending-filtering permanent;
 
 # api-reference/migrate-from-* -> migrating/migrate-from-*
-rewrite ^/docs/hotchocolate/(v13)/api-reference/(migrate-from-.*?)/?$ /docs/hotchocolate/migrating/$2 permanent;
+rewrite ^/docs/hotchocolate/(v11|v12|v13)/api-reference/(migrate-from-.*?)/?$ /docs/hotchocolate/migrating/$2 permanent;
+
+# api-reference/options -> server/options
+rewrite ^/docs/hotchocolate/(v11|v12|v13|v14|v15)/api-reference/options/?$ /docs/hotchocolate/server/options permanent;
+
+# api-reference/relay -> defining-a-schema/relay
+rewrite ^/docs/hotchocolate/(v11)/api-reference/relay/?$ /docs/hotchocolate/defining-a-schema/relay permanent;
+
+# defining-a-schema/extending-types -> defining-a-schema/object-types
+rewrite ^/docs/hotchocolate/(v11|v12|v13|v14|v15)/defining-a-schema/extending-types/?$ /docs/hotchocolate/defining-a-schema/object-types permanent;
+
+# fetching-data/dataloader -> fetching-data/batching/dataloader
+rewrite ^/docs/hotchocolate/(v11|v12|v13|v14|v15)/fetching-data/dataloader/?$ /docs/hotchocolate/fetching-data/batching/dataloader permanent;
+
+# fetching-data/resolvers -> resolvers
+rewrite ^/docs/hotchocolate/(v11|v12|v13|v14|v15)/fetching-data/resolvers/?$ /docs/hotchocolate/resolvers permanent;
+
+# integrations/* -> fetching-data/integrations/*
+rewrite ^/docs/hotchocolate/(?:v11|v12|v13|v14|v15)/integrations/(entity-framework|marten|mongodb)/?$ /docs/hotchocolate/fetching-data/integrations/$1 permanent;
+rewrite ^/docs/hotchocolate/(v11|v12|v13|v14|v15)/integrations/spatial-data/?$ /docs/hotchocolate/fetching-data/spatial-data permanent;
+rewrite ^/docs/hotchocolate/(v11|v12|v13|v14|v15)/integrations/?$ /docs/hotchocolate/fetching-data/integrations permanent;
+
+# server/dependency-injection -> resolvers/dependency-injection
+rewrite ^/docs/hotchocolate/(v10|v12|v13|v14|v15)/server/dependency-injection/?$ /docs/hotchocolate/resolvers/dependency-injection permanent;
+
+# server/introspection -> security/introspection
+rewrite ^/docs/hotchocolate/(v12|v13|v14|v15)/server/introspection/?$ /docs/hotchocolate/security/introspection permanent;
+
+# hotchocolate/fusion -> fusion
+rewrite ^/docs/hotchocolate/(v15)/fusion/?$ /docs/fusion permanent;
+
+# v16 guides -> new locations
+rewrite ^/docs/hotchocolate/(?:v\d+/)?guides/dynamic-schemas/?$ /docs/hotchocolate/defining-a-schema/dynamic-schemas permanent;
+rewrite ^/docs/hotchocolate/(?:v\d+/)?guides/error-handling/?$ /docs/hotchocolate/resolvers/errors permanent;
+rewrite ^/docs/hotchocolate/(?:v\d+/)?guides/(mcp|openapi)-adapter/?$ /docs/hotchocolate/build/adapters/$1 permanent;
+rewrite ^/docs/hotchocolate/(?:v\d+/)?guides/performance/?$ /docs/hotchocolate/performance permanent;
+rewrite ^/docs/hotchocolate/(?:v\d+/)?guides/private-api/?$ /docs/hotchocolate/performance/trusted-documents permanent;
+rewrite ^/docs/hotchocolate/(?:v\d+/)?guides/schema-evolution/?$ /docs/hotchocolate/defining-a-schema/versioning permanent;
+
+# fusion renames (v14/v15; v16 paths match the new structure already)
+rewrite ^/docs/fusion/(v14|v15)/aspire/?$ /docs/fusion/aspire-integration permanent;
+rewrite ^/docs/fusion/(v14|v15)/devops/?$ /docs/fusion/deployment-and-ci-cd permanent;
+rewrite ^/docs/fusion/(v14|v15)/(entities|lookups)/?$ /docs/fusion/entities-and-lookups permanent;
+rewrite ^/docs/fusion/(v14|v15)/node/?$ /docs/fusion/entities-and-lookups#graphql-global-object-identification permanent;
+rewrite ^/docs/fusion/(v14|v15)/quick-start/?$ /docs/fusion/getting-started permanent;
+
+# strawberryshake performance/persisted-queries -> performance/persisted-operations
+rewrite ^/docs/strawberryshake/(v12|v13)/performance/persisted-queries/?$ /docs/strawberryshake/performance/persisted-operations permanent;
+
+# fetching-data/fetching-from-* -> fetching-data
+rewrite ^/docs/hotchocolate/v\d+/fetching-data/fetching-from-(databases|rest)/?$ /docs/hotchocolate/fetching-data permanent;
+
+# distributed-schema -> fusion
+rewrite ^/docs/hotchocolate/v\d+/distributed-schema(?:/.*)?$ /docs/fusion permanent;
 
 # bcp -> nitro
 rewrite ^/docs/bananacakepop(?:/v\d+)?/bcp-services/?$ /docs/nitro/nitro-services permanent;
 rewrite ^/docs/bananacakepop(?:/v\d+)?(/.*[^/])?/?$ /docs/nitro$1 permanent;
 
 # barista -> nitro
-rewrite ^/docs/barista/v1/commands(/.*[^/])?/?$ /docs/nitro/cli-commands$1 permanent;
+rewrite ^/docs/barista/v1/commands/?$ /docs/nitro/cli/installation permanent;
+rewrite ^/docs/barista/v1/commands(/.*[^/])?/?$ /docs/nitro/cli$1 permanent;
+rewrite ^/docs/barista/v1/?$ /docs/nitro/cli/installation permanent;
 rewrite ^/docs/barista/v1(/.*[^/])?/?$ /docs/nitro/cli$1 permanent;
 
-# error-filter -> errors
-rewrite ^/docs/hotchocolate/(v13|v14)/api-reference/error-filter/?$ /docs/hotchocolate/api-reference/errors permanent;
-
 # strip docs version: any remaining versioned docs URL redirects to the
 # unversioned path (must run after the specific legacy rules above)
-rewrite ^/docs/(hotchocolate|strawberryshake|fusion)/v\d+(/.*[^/])?/?$ /docs/$1$2 permanent;
+rewrite ^/docs/(hotchocolate|strawberryshake|fusion|mocha)/v\d+(/.*[^/])?/?$ /docs/$1$2 permanent;
 
 # img/projects -> resources
 rewrite ^/img/projects/greendonut-banner\.svg$ /resources/greendonut-banner.svg permanent;