fix: links and orphan pages (#2824)

NicholasKissel · NicholasKissel · commit d25aced83518 · 2025-07-29T23:47:50.000Z
&lt;!-- Please make sure there is an issue that this PR is correlated to. --&gt;

## Changes

&lt;!-- If there are frontend changes, please include screenshots. --&gt;
diff --git a/site/src/app/(v2)/(blog)/blog/[...slug]/page.tsx b/site/src/app/(v2)/(blog)/blog/[...slug]/page.tsx
@@ -220,7 +220,7 @@ async function OtherArticles({ slug }) {
 				.slice(0, 3)
 				.map((article) => (
 					<li key={article.slug} className="py-1">
-						<Link href={`/blog/${article.slug}`}>
+						<Link href={article.category.id === "changelog" ? `/changelog/${article.slug}` : `/blog/${article.slug}`}>
 							{article.title}
 						</Link>
 					</li>
diff --git a/site/src/app/(v2)/(blog)/blog/page.tsx b/site/src/app/(v2)/(blog)/blog/page.tsx
@@ -26,7 +26,7 @@ function Article({
 	image,
 	category,
 }) {
-	const href = `/blog/${slug}`;
+	const href = category.id === "changelog" ? `/changelog/${slug}` : `/blog/${slug}`;
 	return (
 		<Link href={href} className="size-full">
 			<article className="bg-card hover:border-primary flex size-full flex-col items-start justify-between rounded-md border p-4 transition-colors">
diff --git a/site/src/app/(v2)/(blog)/changelog/[...slug]/page.tsx b/site/src/app/(v2)/(blog)/changelog/[...slug]/page.tsx
@@ -141,7 +141,7 @@ async function OtherArticles({ slug }) {
 				.slice(0, 3)
 				.map((article) => (
 					<li key={article.slug} className="py-1">
-						<Link href={`/blog/${article.slug}`}>
+						<Link href={`/changelog/${article.slug}`}>
 							{article.title}
 						</Link>
 					</li>
diff --git a/site/src/app/(v2)/(marketing)/rivet-vs-cloudflare-workers/page.tsx b/site/src/app/(v2)/(marketing)/rivet-vs-cloudflare-workers/page.tsx
@@ -898,7 +898,7 @@ const MigrationSection = () => {
 				</p>
 				<div className="mt-6">
 					<Link
-						href="/talk-to-an-engineer "
+						href="/talk-to-an-engineer"
 						className="inline-flex items-center px-5 py-2.5 bg-white text-black rounded-md hover:bg-white/90 transition-colors no-underline"
 					>
 						Talk to an engineer
diff --git a/site/src/content/docs/actors/actions.mdx b/site/src/content/docs/actors/actions.mdx
@@ -47,7 +47,7 @@ const result = await counter.increment(42);
 console.log(result); // The value returned by the action
 ```
 
-Learn more about [communicating with actors from the frontend](/docs/actors/communicating-with-actors).
+Learn more about [communicating with actors from the frontend](/docs/actors/communicating-between-actors).
 
 </Tab>
 <Tab title="Backend (registry.runServer)">
@@ -67,7 +67,7 @@ const result = await counter.increment(42);
 console.log(result);
 ```
 
-Learn more about [communicating with actors from the backend](/docs/actors/communicating-with-actors).
+Learn more about [communicating with actors from the backend](/docs/actors/communicating-between-actors).
 
 </Tab>
 <Tab title="Actor-to-Actor (c.client())">
@@ -232,7 +232,7 @@ const counter = actor({
 
 By default, actors' actions are only accessible from your server-side client.
 
-In order to expose actions publicly to the external client, you'll need to define `onAuth`. More documentation on authentication is available [here](/docs/general/authentication). Read more about the [types of clients](/docs/actors/clients)
+In order to expose actions publicly to the external client, you'll need to define `onAuth`. More documentation on authentication is available [here](/docs/actors/authentication). Read more about the [types of clients](/docs/actors/clients)
 
 ## Streaming Return Data
 
diff --git a/site/src/content/docs/actors/clients.mdx b/site/src/content/docs/actors/clients.mdx
@@ -38,7 +38,7 @@ There are several ways to create a client for communicating with actors:
 		serve(app);
 		```
 
-		This client doesn't [require authentication](/docs/general/authentication).
+		This client doesn't [require authentication](/docs/actors/authentication).
 	</Tab>
 
 	<Tab title="External Client">
@@ -67,7 +67,7 @@ There are several ways to create a client for communicating with actors:
 		});
 		```
 
-		This client [requires authentication](/docs/general/authentication).
+		This client [requires authentication](/docs/actors/authentication).
 
 		**Important**: Use `import type` when importing the registry type in order to
 		avoid accidentally bundling your backend code.
@@ -97,7 +97,7 @@ There are several ways to create a client for communicating with actors:
 		});
 		```
 
-		This client doesn't [require authentication](/docs/general/authentication).
+		This client doesn't [require authentication](/docs/actors/authentication).
 
 		Read more about [communicating between actors](/docs/actors/communicating-between-actors).
 	</Tab>
@@ -432,7 +432,7 @@ const protectedActor = actor({
 });
 ```
 
-Learn more about [authentication patterns](/docs/general/authentication).
+Learn more about [authentication patterns](/docs/actors/authentication).
 
 ## Type Safety
 
diff --git a/site/src/content/docs/actors/connections.mdx b/site/src/content/docs/actors/connections.mdx
@@ -251,4 +251,4 @@ function ConnectionErrorHandler() {
 
 ## Offline & Auto-Reconnection
 
-See [client documentation](/docs/actors/communicating-with-actors) for details on reconnection behavior.
+See [client documentation](/docs/actors/communicating-between-actors) for details on reconnection behavior.
diff --git a/site/src/content/docs/actors/fetch-and-websocket-handler.mdx b/site/src/content/docs/actors/fetch-and-websocket-handler.mdx
@@ -542,7 +542,7 @@ If you are using the external client, authentication is handled through the `onA
 
 If you are using the server-side client, then authentication is skipped by default.
 
-See the [authentication documentation](/docs/general/authentication) for detailed information on implementing authentication patterns.
+See the [authentication documentation](/docs/actors/authentication) for detailed information on implementing authentication patterns.
 
 
 ## State Saves
diff --git a/site/src/content/docs/actors/index.mdx b/site/src/content/docs/actors/index.mdx
@@ -110,7 +110,7 @@ const room = client.chatRoom.getOrCreate(["general"]);
 const message = await room.sendMessage("user-123", "Hello everyone!");
 ```
 
-Learn more about [actions](/docs/actors/actions) and [communicating with actors](/docs/actors/communicating-with-actors).
+Learn more about [actions](/docs/actors/actions) and [communicating with actors](/docs/actors/communicating-between-actors).
 
 ### Real-time Communication & Events
 
@@ -147,7 +147,7 @@ connection.on("newBid", (data) => {
 await auction.placeBid(150);
 ```
 
-Learn more about [events](/docs/actors/events) and [client communication](/docs/actors/communicating-with-actors).
+Learn more about [events](/docs/actors/events) and [client communication](/docs/actors/communicating-between-actors).
 
 ### Scheduling & Lifecycle
 
diff --git a/site/src/content/docs/actors/lifecycle.mdx b/site/src/content/docs/actors/lifecycle.mdx
@@ -222,7 +222,7 @@ const chatRoom = actor({
 });
 ```
 
-Connections cannot interact with the actor until this method completes successfully. Throwing an error will abort the connection. This can be used for authentication - see [Authentication](/docs/general/authentication) for details.
+Connections cannot interact with the actor until this method completes successfully. Throwing an error will abort the connection. This can be used for authentication - see [Authentication](/docs/actors/authentication) for details.
 
 ### `onConnect`
 
diff --git a/site/src/content/docs/clients/javascript.mdx b/site/src/content/docs/clients/javascript.mdx
@@ -133,5 +133,5 @@ The Rivet JavaScript client allows you to connect to and interact with actors fr
 
 ## Next Steps
 
-For more information on communicating with actors, including event handling and RPC calls, see [Communicating with Actors](/docs/actors/communicating-with-actors).
+For more information on communicating with actors, including event handling and RPC calls, see [Communicating with Actors](/docs/actors/communicating-between-actors).
 
diff --git a/site/src/content/docs/clients/react.mdx b/site/src/content/docs/clients/react.mdx
@@ -349,5 +349,5 @@ function AuthenticatedApp() {
 }
 ```
 
-Learn more about [authentication](/docs/general/authentication).
+Learn more about [authentication](/docs/actors/authentication).
 
diff --git a/site/src/content/docs/cloud/api/index.mdx b/site/src/content/docs/cloud/api/index.mdx
@@ -4,13 +4,13 @@ The Rivet API provides HTTP endpoints for managing your serverless infrastructur
 
 ## Authentication
 
-All API requests require [authentication tokens](/docs/tokens). Use these tokens with the `Authorization` header.
+All API requests require [authentication tokens](/docs/cloud/tokens). Use these tokens with the `Authorization` header.
 
 ## Resources
 
 - **[Actors](/docs/actors)** - Stateful serverless containers
 - **[Builds](/docs/config)** - Code deployments
-- **[Routes](/docs/networking)** - HTTP routing configuration
+- **[Routes](/docs/cloud/networking)** - HTTP routing configuration
 - **[Regions](/docs/edge)** - Global deployment locations
 
 ## SDKs
@@ -21,7 +21,7 @@ While you can use the HTTP API directly, we recommend using our official SDKs:
 - [Go](https://github.com/rivet-gg/rivet/tree/main/sdks/api/runtime/go)
 - [Rust](https://github.com/rivet-gg/rivet/tree/main/sdks/api/runtime/rust)
 - [OpenAPI](https://github.com/rivet-gg/rivet/blob/main/sdks/api/runtime/openapi/openapi.yml)
-- [Command Line Interface](/docs/cli)
+- [Command Line Interface](/docs/cloud/cli)
 
 ## Error Handling
 
diff --git a/site/src/content/docs/cloud/cli.mdx b/site/src/content/docs/cloud/cli.mdx
@@ -4,7 +4,7 @@ The Rivet Command Line Interface (CLI) provides a set of tools for deploying, ma
 
 ## Installation
 
-For installation instructions, see [Install](/docs/install).
+For installation instructions, see [Install](/docs/cloud/install).
 
 ## Overview
 
@@ -90,7 +90,7 @@ rivet environment view
 
 Rivet CLI can be configured using the following environment variables:
 
-- `RIVET_CLOUD_TOKEN` - See [tokens documentation](/docs/tokens) on instructions on how to create a cloud token
+- `RIVET_CLOUD_TOKEN` - See [tokens documentation](/docs/cloud/tokens) on instructions on how to create a cloud token
 - `RIVET_ENDPOINT` - Custom API endpoint (for self-hosted or enterprise instances)
 
 ## CI/CD Integration
diff --git a/site/src/content/docs/cloud/continuous-delivery.mdx b/site/src/content/docs/cloud/continuous-delivery.mdx
@@ -10,8 +10,8 @@ Before setting up continuous delivery, you need a working Rivet application:
 
 1. Set up your application using one of the following guides:
    - [Actors](/docs/actors)
-   - [Containers](/docs/containers)
-   - [Functions](/docs/functions)
+   - [Containers](/docs/cloud/containers)
+- [Functions](/docs/cloud/functions)
 
 2. Make sure you have a working `rivet.json` configuration file in your project
 
@@ -36,7 +36,7 @@ Next, add the token to GitHub Actions Secrets:
 4. Paste your Rivet Cloud Token as the value
 5. Click "Add secret"
 
-For more information on Rivet tokens, see the [Tokens documentation](/docs/tokens).
+For more information on Rivet tokens, see the [Tokens documentation](/docs/cloud/tokens).
 
 ### Step 3: Create GitHub Actions Workflow
 
diff --git a/site/src/content/docs/cloud/environment-variables.mdx b/site/src/content/docs/cloud/environment-variables.mdx
@@ -53,4 +53,4 @@ Rivet provides the following default environment variables:
 
 - `PORT_{NAME}`: The port number assigned to a named port (e.g., `PORT_HTTP` for a port named "http")
 
-For more details about networking and ports, see [Networking](/docs/networking).
+For more details about networking and ports, see [Networking](/docs/cloud/networking).
diff --git a/site/src/content/docs/cloud/functions.mdx b/site/src/content/docs/cloud/functions.mdx
@@ -84,7 +84,7 @@ CMD ["node", "index.js"]
 	**Configuring port**: By default, Rivet Functions will listen on port 8080. This can be configured using the `networking.internal_port` option in your configuration (see [Configuration Options](#configuration-options) below).
 </Info>
 
-See [Rivet Containers documentation](/docs/containers) for more information on writing code for the Rivet platform.
+See [Rivet Containers documentation](/docs/cloud/containers) for more information on writing code for the Rivet platform.
 
 ### 2. Deploy your function
 
diff --git a/site/src/content/docs/cloud/index.mdx b/site/src/content/docs/cloud/index.mdx
@@ -19,7 +19,7 @@ Rivet is the open-source serverless platform to scale complex backends anywhere
 
 **Replaces**: Cloudflare Workers, AWS Lambda, Google Cloud Run Functions
 
-[Get Started →](/docs/functions)
+[Get Started →](/docs/cloud/functions)
 
 ## <Icon icon={faActorsBorderless} className="mr-2" /> Stateful Actors
 
@@ -43,5 +43,5 @@ Rivet is the open-source serverless platform to scale complex backends anywhere
 
 **Replaces**: Kubernetes Batch Jobs, AWS Fargate, Google Cloud Run
 
-[Get Started →](/docs/containers)
+[Get Started →](/docs/cloud/containers)
 
diff --git a/site/src/content/docs/cloud/local-development.mdx b/site/src/content/docs/cloud/local-development.mdx
@@ -22,5 +22,5 @@
 
 ## Configuration
 
-For more information on configuring the container, see the [single container self-hosting documentation](/docs/self-hosting/single-container).
+For more information on configuring the container, see the [single container self-hosting documentation](/docs/cloud/self-hosting/single-container).
 
diff --git a/site/src/content/docs/cloud/self-hosting/index.mdx b/site/src/content/docs/cloud/self-hosting/index.mdx
@@ -12,14 +12,14 @@ Join <Link href='/discord'>our Discord</Link> if you have any questions, we're h
 ## Deployment Methods
 
 <CardGroup>
-  <Card title="Local Dev & Single Container" href="/docs/self-hosting/single-container">Best for local dev, including in existing Docker Compose, and single-node deployments.</Card>
-  <Card title="Docker Compose" href="/docs/self-hosting/docker-compose">Best for quick hobby setups.</Card>
-  <Card title="Manual Deployment" href="/docs/self-hosting/manual-deployment">Best for complex architectures. Requires familiarity with Linux systems.</Card>
+  <Card title="Local Dev & Single Container" href="/docs/cloud/self-hosting/single-container">Best for local dev, including in existing Docker Compose, and single-node deployments.</Card>
+<Card title="Docker Compose" href="/docs/cloud/self-hosting/docker-compose">Best for quick hobby setups.</Card>
+<Card title="Manual Deployment" href="/docs/cloud/self-hosting/manual-deployment">Best for complex architectures. Requires familiarity with Linux systems.</Card>
 </CardGroup>
 
 ## Resources
 
 <CardGroup>
-  <Card title="Server Config" href="/docs/self-hosting/server-config" />
-  <Card title="Client Config" href="/docs/self-hosting/client-config" />
+  <Card title="Server Config" href="/docs/cloud/self-hosting/server-config" />
+<Card title="Client Config" href="/docs/cloud/self-hosting/client-config" />
 </CardGroup>
diff --git a/site/src/content/docs/cloud/self-hosting/manual-deployment.mdx b/site/src/content/docs/cloud/self-hosting/manual-deployment.mdx
@@ -2,12 +2,12 @@ import Link from 'next/link';
 
 # Manual Deployment
 
-Manual deployment of Rivet is meant for advanced use cases. For a simpler solution, try <Link href='/docs/self-hosting/docker-compose'>our Docker Compose</Link>.
+Manual deployment of Rivet is meant for advanced use cases. For a simpler solution, try <Link href='/docs/cloud/self-hosting/docker-compose'>our Docker Compose</Link>.
 
 <Tip>
 	**Get started faster with a single container**: If you're deploying Rivet on a single machine or just want to try it, Rivet
 	can be started with a single `docker run` command. See [Single Container
-	Deployments](/docs/self-hosting/single-container) for more information.
+	Deployments](/docs/cloud/self-hosting/single-container) for more information.
 </Tip>
 
 ## Prerequisites
@@ -40,7 +40,7 @@ Edge server:
    - <Link href='https://docs.nats.io/nats-concepts/what-is-nats'>NATS</Link>
    - <Link href='https://vector.dev/docs/setup/installation/'>Vector</Link>
 
-2. Setup the <Link href='/docs/self-hosting/server-config'>Rivet server config</Link> with your existing components:
+2. Setup the <Link href='/docs/cloud/self-hosting/server-config'>Rivet server config</Link> with your existing components:
 
    ```yaml {{ "file": "rivet.yaml" }}
    server:
@@ -101,7 +101,7 @@ Once running, you can visit the dashboard at <Link href='http://localhost:8080'>
    This guide assumes you already have <Link href='https://apple.github.io/foundationdb/getting-started-linux.html'>FoundationDB</Link> running on
    the edge.
 
-2. Setup the <Link href='/docs/self-hosting/client-config'>Rivet client config</Link>:
+2. Setup the <Link href='/docs/cloud/self-hosting/client-config'>Rivet client config</Link>:
 
    ```yaml {{ "file": "rivet.yaml" }}
    client:
diff --git a/site/src/content/docs/cloud/self-hosting/network-modes.mdx b/site/src/content/docs/cloud/self-hosting/network-modes.mdx
@@ -65,7 +65,7 @@ Rivet Guard routing can be used with either host or bridge network modes.
 _Requires enterprise or self-hosted cluster._
 
 Host ports do not provide any proxying between the end-user and your application and **are not enabled on
-production Rivet servers**. This is primarily an option for <Link href='/docs/self-hosting'>self hosting</Link> Rivet.
+production Rivet servers**. This is primarily an option for <Link href='/docs/cloud/self-hosting'>self hosting</Link> Rivet.
 
 It is recommended to use Rivet Guard whenever possible for production applications
 to better protect from DDoS attacks & improve monitoring of your application.
diff --git a/site/src/content/docs/cloud/solutions/game-servers.mdx b/site/src/content/docs/cloud/solutions/game-servers.mdx
@@ -111,7 +111,7 @@ Create a minimal `rivet.json` configuration file that tells Rivet how to deploy
 
 ### Step 3: Deploying your game server
 
-Install the Rivet CLI [here](/docs/install). Then deploy your game server to Rivet using the CLI:
+Install the Rivet CLI [here](/docs/cloud/install). Then deploy your game server to Rivet using the CLI:
 
 ```bash
 rivet deploy
diff --git a/site/src/content/docs/cloud/tokens.mdx b/site/src/content/docs/cloud/tokens.mdx
@@ -52,5 +52,5 @@ curl -H "Authorization: Bearer $RIVET_SERVICE_TOKEN" 'https://api.rivet.gg/actor
 
 Rivet offers a `rivet shell` command that will auto-create a service token & populate common environment variables for executing commands that depend on tokens.
 
-See the [`rivet shell` documentation](/docs/cli#shell) for more information.
+See the [`rivet shell` documentation](/docs/cloud/cli#shell) for more information.
 
diff --git a/site/src/posts/2025-07-01-introducing-rivetkit-backend-libraries-that-replace-saas/page.mdx b/site/src/posts/2025-07-01-introducing-rivetkit-backend-libraries-that-replace-saas/page.mdx
@@ -234,7 +234,7 @@ const chatRoom = actor({
 })
 ```
 
-See the [authentication documentation](/docs/general/authentication) for more details.
+See the [authentication documentation](/docs/actors/authentication) for more details.
 
 ### Better Auth Integration
 
@@ -296,7 +296,7 @@ For example:
 const chatThread = client.chatThread.getOrCreate([roomId, threadId]);
 ```
 
-See the new [actor handles documentation](/docs/actors/communicating-with-actors).
+See the new [actor handles documentation](/docs/actors/communicating-between-actors).
 
 ### Pass Input to create
 
@@ -322,7 +322,7 @@ const newGame = await client.game.create(["game-456"], {
 });
 ```
 
-Read more about [creating actors](/docs/actors/communicating-with-actors).
+Read more about [creating actors](/docs/actors/communicating-between-actors).
 
 ### Stateless Communication With Actors
 
diff --git a/site/src/sitemap/mod.ts b/site/src/sitemap/mod.ts

Original file line number	Diff line number	Diff line change
`@@ -898,7 +898,7 @@ const MigrationSection = () => {`
`898`	`898`	`</p>`
`899`	`899`	`<div className="mt-6">`
`900`	`900`	`<Link`
`901`		`- href="/talk-to-an-engineer "`
	`901`	`+ href="/talk-to-an-engineer"`
`902`	`902`	`className="inline-flex items-center px-5 py-2.5 bg-white text-black rounded-md hover:bg-white/90 transition-colors no-underline"`
`903`	`903`	`>`
`904`	`904`	`Talk to an engineer`
Original file line number	Diff line number	Diff line change
`@@ -251,4 +251,4 @@ function ConnectionErrorHandler() {`
`251`	`251`
`252`	`252`	`## Offline & Auto-Reconnection`
`253`	`253`
`254`		`-See [client documentation](/docs/actors/communicating-with-actors) for details on reconnection behavior.`
	`254`	`+See [client documentation](/docs/actors/communicating-between-actors) for details on reconnection behavior.`