From 44ac5e67924ec9e4d3ee2c0ce889f4cfe2fb4615 Mon Sep 17 00:00:00 2001
From: a16raj <a16raj@gmail.com>
Date: Thu, 20 Aug 2026 13:19:38 +0530
Subject: [PATCH] fix(docs): add blank lines around Tab contents and fix CI on
 forks

The MDX parser used by the documentation site requires blank lines
between block-level components (like \<Tab>\) and their markdown or
component children (like \<CodeSnippet>\) to correctly parse them as
block content rather than inline HTML.

This fixes the broken formatting reported when multiple tabs are
present, where the first tab lacked trailing newlines (fixes #5566).

Additionally, this adds a repository check to \docs-sync.yml\ and
\mirror-swift.yml\ to prevent them from failing when run on forks
where the required PAT secrets are not present.
---
 .github/workflows/docs-sync.yml      |  1 +
 .github/workflows/mirror-swift.yml   |  1 +
 docs/content/docs/authentication.mdx |  4 ++++
 docs/content/docs/connections.mdx    |  3 +++
 docs/content/docs/crash-course.mdx   | 12 ++++++++++++
 5 files changed, 21 insertions(+)

diff --git a/.github/workflows/docs-sync.yml b/.github/workflows/docs-sync.yml
index 6fe0cfaea0..738203e512 100644
--- a/.github/workflows/docs-sync.yml
+++ b/.github/workflows/docs-sync.yml
@@ -11,6 +11,7 @@ on:
 
 jobs:
   sync:
+    if: github.repository == 'rivet-dev/actors'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
diff --git a/.github/workflows/mirror-swift.yml b/.github/workflows/mirror-swift.yml
index 0d16e43061..28d6b3ad49 100644
--- a/.github/workflows/mirror-swift.yml
+++ b/.github/workflows/mirror-swift.yml
@@ -11,6 +11,7 @@ on:
 
 jobs:
   mirror:
+    if: github.repository == 'rivet-dev/actors'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
diff --git a/docs/content/docs/authentication.mdx b/docs/content/docs/authentication.mdx
index 1ff904881e..436f31e33c 100644
--- a/docs/content/docs/authentication.mdx
+++ b/docs/content/docs/authentication.mdx
@@ -8,16 +8,20 @@ skill: true
 
 <Tabs>
 <Tab title="Rivet Cloud">
+
 	Actors are private by default on Rivet Cloud. Only requests with the publishable token can interact with actors.
 
 	- **Backend-only actors**: If your publishable token is only included in your backend, then authentication is not necessary.
 	- **Frontend-accessible actors**: If your publishable token is included in your frontend, then implementing authentication is recommended.
+
 </Tab>
 <Tab title="Self-Hosted">
+
 	Actors are public by default on self-hosted Rivet. Anyone can access them without a token.
 
 	- **Only accessible within private network**: If Rivet is only accessible within your private network, then authentication is not necessary.
 	- **Rivet exposed to the public internet**: If Rivet is configured to accept traffic from the public internet, then implementing authentication is recommended.
+
 </Tab>
 </Tabs>
 
diff --git a/docs/content/docs/connections.mdx b/docs/content/docs/connections.mdx
index 2f7ad4e3c4..a925899783 100644
--- a/docs/content/docs/connections.mdx
+++ b/docs/content/docs/connections.mdx
@@ -25,7 +25,9 @@ For example:
 There are two ways to define an actor's connection state:
 
 <Tabs>
+
 	<Tab title="connState">
+
 		Define connection state as a constant value:
 
 		<CodeSnippet file="examples/docs/actors-connections/conn-state-const.ts" />
@@ -34,6 +36,7 @@ There are two ways to define an actor's connection state:
 	</Tab>
 
 	<Tab title="createConnState">
+
 		Create connection state dynamically with a function called for each connection:
 
 		<CodeSnippet file="examples/docs/actors-connections/conn-state-dynamic.ts" />
diff --git a/docs/content/docs/crash-course.mdx b/docs/content/docs/crash-course.mdx
index 4e7b05d5e9..81fc67082e 100644
--- a/docs/content/docs/crash-course.mdx
+++ b/docs/content/docs/crash-course.mdx
@@ -46,9 +46,12 @@ Persistent data that survives restarts, crashes, and deployments. State is persi
 
 <Tabs>
 <Tab title="Static Initial State">
+
 <CodeSnippet file="examples/docs/actors-crash-course/state-static.ts" />
+
 </Tab>
 <Tab title="Dynamic Initial State">
+
 <CodeSnippet file="examples/docs/actors-crash-course/state-dynamic.ts" />
 
 </Tab>
@@ -80,9 +83,12 @@ Temporary data that doesn't survive restarts. Use for non-serializable objects (
 
 <Tabs>
 <Tab title="Static Initial Vars">
+
 <CodeSnippet file="examples/docs/actors-crash-course/vars-static.ts" />
+
 </Tab>
 <Tab title="Dynamic Initial Vars">
+
 <CodeSnippet file="examples/docs/actors-crash-course/vars-dynamic.ts" />
 
 </Tab>
@@ -114,9 +120,12 @@ Access the current connection via `c.conn` or all connected clients via `c.conns
 
 <Tabs>
 <Tab title="Static Connection Initial State">
+
 <CodeSnippet file="examples/docs/actors-crash-course/conn-static.ts" />
+
 </Tab>
 <Tab title="Dynamic Connection Initial State">
+
 <CodeSnippet file="examples/docs/actors-crash-course/conn-dynamic.ts" />
 
 </Tab>
@@ -186,9 +195,12 @@ Use `UserError` to throw errors that are safely returned to clients. Pass `metad
 
 <Tabs>
 <Tab title="Actor">
+
 <CodeSnippet file="examples/docs/actors-crash-course/errors-actor.ts" />
+
 </Tab>
 <Tab title="Client">
+
 <CodeSnippet file="examples/docs/actors-crash-course/errors-client.ts" />
 
 </Tab>