LLM Benchmark docs updates from testings (#4416)

# Description of Changes

Documentation updates from llm-benchmark testing. Includes:

- **Core concepts**: Tables, column types, auto-increment, indexes,
access permissions, schedule tables, event tables, performance
- **Client references**: C# and TypeScript reference updates
- **Migration guide**: 2.0 migration docs
- **AI rules**: `spacetimedb-csharp.mdc`, `spacetimedb-typescript.mdc`,
new `spacetimedb-migration-2.0.mdc`
- **Cheat sheet**: Database cheat sheet updates
- **Reducers, procedures, reducer context**: Small fixes and
clarifications
- **llms.md**: LLM-related doc updates

# API and ABI breaking changes

None. Documentation only.

# Expected complexity level and risk

**Complexity: 2** — Broad docs changes but no code. Risk is limited to
incorrect or misleading docs.

# Testing

- [ ] Build docs site and confirm it renders
- [ ] Spot-check updated pages (tables, schedule tables, cheat sheet,
client references)
- [ ] Confirm C# tutorial examples use `nameof(...)` and snake_case

---------

Signed-off-by: bradleyshep <148254416+bradleyshep@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Tyler Cloutier <cloutiertyler@users.noreply.github.com>
Co-authored-by: joshua-spacetime <josh@clockworklabs.io>

Author: 4 people

docs/docs/00100-intro/00300-tutorials/00300-unity-tutorial/00400-part-3.md

@@ -350,7 +350,7 @@ public static void Init(ReducerContext ctx)
 
 :::note
 
-You can use `ScheduleAt.Interval` to schedule a reducer call at an interval like we're doing here. SpacetimeDB will continue to call the reducer at this interval until you remove the row. You can also use `ScheduleAt.Time()` to specify a specific at which to call a reducer once. SpacetimeDB will remove that row automatically after the reducer has been called.
+You can use `ScheduleAt.Interval` to schedule a reducer call at an interval like we're doing here. SpacetimeDB will continue to call the reducer at this interval until you remove the row. You can also use `new ScheduleAt.Time(...)` to schedule a reducer once at a specific time. SpacetimeDB will remove that row automatically after the reducer has been called.
 
 :::
 

docs/docs/00100-intro/00300-tutorials/00400-unreal-tutorial/00400-part-3.md

@@ -347,7 +347,7 @@ public static void Init(ReducerContext ctx)
 ```
 
 :::note
-You can use `ScheduleAt.Interval` to schedule a reducer call at an interval like we're doing here. SpacetimeDB will continue to call the reducer at this interval until you remove the row. You can also use `ScheduleAt.Time()` to specify a specific at which to call a reducer once. SpacetimeDB will remove that row automatically after the reducer has been called.
+You can use `ScheduleAt.Interval` to schedule a reducer call at an interval like we're doing here. SpacetimeDB will continue to call the reducer at this interval until you remove the row. You can also use `new ScheduleAt.Time(...)` to schedule a reducer once at a specific time. SpacetimeDB will remove that row automatically after the reducer has been called.
 :::
 
 </TabItem>

docs/docs/00200-core-concepts/00100-databases/00500-cheat-sheet.md

@@ -102,7 +102,7 @@ const status = t.enum('Status', ['Active', 'Inactive']);
 using SpacetimeDB;
 
 // Basic table
-[SpacetimeDB.Table(Public = true)]
+[SpacetimeDB.Table(Accessor = "Player", Public = true)]
 public partial struct Player
 {
     [SpacetimeDB.PrimaryKey]
@@ -116,27 +116,27 @@ public partial struct Player
     public int Score;
 }
 
-// Multi-column index
-[SpacetimeDB.Table]
-[SpacetimeDB.Index.BTree(Accessor = "idx", Columns = ["PlayerId", "Level"])]
+// Multi-column index (use new[] for attribute params — collection expressions invalid in attributes)
+[SpacetimeDB.Table(Accessor = "Score")]
+[SpacetimeDB.Index.BTree(Accessor = "idx", Columns = new[] { "PlayerId", "Level" })]
 public partial struct Score
 {
     public ulong PlayerId;
     public uint Level;
 }
 
-// Custom types
+// Sum types: TaggedEnum with partial record (not partial class)
 [SpacetimeDB.Type]
-public enum Status
-{
-    Active,
-    Inactive,
-}
+public partial record Status : TaggedEnum<(Unit Active, Unit Inactive)> { }
 ```
 
 </TabItem>
 <TabItem value="rust" label="Rust">
 
+:::tip Table access
+Table accessors use **snake_case**. Use `ctx.db.player()` not `ctx.db.Player`.
+:::
+
 ```rust
 use spacetimedb::{table, SpacetimeType};
 
@@ -145,21 +145,21 @@ use spacetimedb::{table, SpacetimeType};
 pub struct Player {
     #[primary_key]
     #[auto_inc]
-    id: u64,
+    pub id: u64,
     #[unique]
-    username: String,
+    pub username: String,
     #[index(btree)]
-    score: i32,
+    pub score: i32,
 }
 
 // Multi-column index
 #[table(accessor = score, index(accessor = idx, btree(columns = [player_id, level])))]
 pub struct Score {
-    player_id: u64,
-    level: u32,
+    pub player_id: u64,
+    pub level: u32,
 }
 
-// Custom types
+// Custom types (product types need #[derive(SpacetimeType)])
 #[derive(SpacetimeType)]
 pub enum Status {
     Active,
@@ -268,8 +268,12 @@ ctx.Db.Player.Id.Delete(123);                      // Delete by primary key
 </TabItem>
 <TabItem value="rust" label="Rust">
 
+:::warning Required for Reducers
+Include `Table` in imports when using `ctx.db.*.insert()`, `.iter()`, `.get_by_id()`, etc. Without it: `no method named 'insert' found`. Use `use spacetimedb::{..., Table};`
+:::
+
 ```rust
-use spacetimedb::{reducer, ReducerContext};
+use spacetimedb::{reducer, ReducerContext, Table};
 
 // Basic reducer
 #[reducer]
@@ -388,6 +392,10 @@ SPACETIMEDB_CLIENT_DISCONNECTED(on_disconnect, ReducerContext ctx) { /* ... */ }
 
 ## Schedule Tables
 
+:::important TypeScript: ScheduleAt import
+`ScheduleAt` is imported from `'spacetimedb'`, **not** from `'spacetimedb/server'`. Use: `import { ScheduleAt } from 'spacetimedb';`
+:::
+
 <Tabs groupId="server-language" queryString>
 <TabItem value="typescript" label="TypeScript">
 
@@ -435,15 +443,17 @@ public static void SendReminder(ReducerContext ctx, Reminder reminder)
 pub struct Reminder {
     #[primary_key]
     #[auto_inc]
-    id: u64,
-    message: String,
-    scheduled_at: ScheduleAt,
+    pub id: u64,
+    pub message: String,
+    pub scheduled_at: ScheduleAt,
 }
 
 #[reducer]
-fn send_reminder(ctx: &ReducerContext, reminder: Reminder) {
+pub fn send_reminder(ctx: &ReducerContext, reminder: Reminder) {
     log::info!("Reminder: {}", reminder.message);
 }
+
+// To schedule: Duration::from_millis(50).into() for ScheduleAt
 ```
 
 </TabItem>
@@ -521,6 +531,7 @@ public static string FetchData(ProcedureContext ctx, string url)
 
 ```rust
 // In Cargo.toml: spacetimedb = { version = "1.*", features = ["unstable"] }
+use spacetimedb::Table;
 
 #[spacetimedb::procedure]
 fn fetch_data(ctx: &mut ProcedureContext, url: String) -> String {
@@ -773,6 +784,44 @@ LOG_DEBUG("Debug: " + msg);
 </TabItem>
 </Tabs>
 
+## Common Mistakes
+
+<Tabs groupId="server-language" queryString>
+<TabItem value="typescript" label="TypeScript">
+
+1. **ScheduleAt import** — Import `ScheduleAt` from `'spacetimedb'`, not `'spacetimedb/server'`.
+2. **Schema-first** — Create `const spacetimedb = schema({...})` before reducers/init/clientConnected.
+3. **`schema()` shape** — Use `schema({ table })` or `schema({ a, b })`, not `schema(table)` or `schema(a, b)`.
+4. **Reducer naming** — Reducer names come from exports: `export const doThing = spacetimedb.reducer(...)`. Do not pass a string name.
+5. **No `ReducerContext` import** — Use the `ctx` parameter; do not import `ReducerContext`.
+6. **Export rules** — Only export schema, reducers, init, clientConnected, clientDisconnected, views. Keep helpers local.
+7. **Use `spacetimedb/server`** — For modules, use `spacetimedb/server` (builder API), not `spacetimedb-sdk` (client decorators).
+8. **`t.object` not `t.struct`** — Use `t.object('Name', {...})` for product types.
+9. **`autoInc` not `autoIncrement`** — Use `.autoInc()` on column builders.
+
+</TabItem>
+<TabItem value="csharp" label="C#">
+
+_See Rust tab for module-specific tips._
+
+</TabItem>
+<TabItem value="rust" label="Rust">
+
+1. **Missing Table import** — Add `use spacetimedb::Table` when using `insert`, `iter`, `get_by_id`, or `update`.
+2. **Wrong table access** — Use `ctx.db.user()` not `ctx.db.User` (accessor is snake_case).
+3. **Wrong scheduled table syntax** — Use `#[table(..., scheduled(reducer_name))]` (reducer name in parentheses). Not `schedule(reducer = ..., column = ...)` or `scheduled = tick`.
+4. **Missing `pub` on fields** — Struct and enum fields in tables must be `pub`.
+5. **Wrong reducer attribute** — Use `#[reducer]` or `#[spacetimedb::reducer]`, not `#[spacetime::reducer]`.
+6. **Product types** — Structs used in table columns need `#[derive(SpacetimeType)]`.
+
+</TabItem>
+<TabItem value="cpp" label="C++">
+
+_See Rust tab for module-specific tips._
+
+</TabItem>
+</Tabs>
+
 ## Common CLI Commands
 
 ```bash

docs/docs/00200-core-concepts/00200-functions/00300-reducers/00300-reducers.md

@@ -542,7 +542,8 @@ Reducers cannot call procedures directly (procedures may have side effects incom
 <TabItem value="typescript" label="TypeScript">
 
 ```typescript
-import { schema, t, table, SenderError } from 'spacetimedb/server';
+import { ScheduleAt } from 'spacetimedb';
+import { schema, t, table } from 'spacetimedb/server';
 
 // Define a schedule table for the procedure
 const fetchSchedule = table(
@@ -558,8 +559,7 @@ const spacetimedb = schema({ fetchSchedule });
 export default spacetimedb;
 
 // The procedure to be scheduled
-const fetchExternalData = spacetimedb.procedure(
-  'fetch_external_data',
+export const fetch_external_data = spacetimedb.procedure(
   { arg: fetchSchedule.rowType },
   t.unit(),
   (ctx, { arg }) => {
@@ -570,7 +570,7 @@ const fetchExternalData = spacetimedb.procedure(
 );
 
 // From a reducer, schedule the procedure by inserting into the schedule table
-const queueFetch = spacetimedb.reducer('queue_fetch', { url: t.string() }, (ctx, { url }) => {
+export const queueFetch = spacetimedb.reducer({ url: t.string() }, (ctx, { url }) => {
   ctx.db.fetchSchedule.insert({
     scheduled_id: 0n,
     scheduled_at: ScheduleAt.interval(0n), // Run immediately

docs/docs/00200-core-concepts/00200-functions/00300-reducers/00400-reducer-context.md

@@ -63,11 +63,21 @@ public static partial class Module
 }
 ```
 
+:::note C# table accessors
+Table accessors use PascalCase: `ctx.Db.User`, `ctx.Db.Player`. The codegen derives these from table names.
+:::
+
 </TabItem>
 <TabItem value="rust" label="Rust">
 
+:::warning Required for Reducers
+Every reducer that uses `ctx.db.*.insert()`, `.iter()`, `.get_by_id()`, etc. **must** include `Table` in its imports:
+`use spacetimedb::{..., Table};`
+Without it you get: `no method named 'insert' found`.
+:::
+
 ```rust
-use spacetimedb::{table, reducer, ReducerContext};
+use spacetimedb::{table, reducer, ReducerContext, Table};
 
 #[table(accessor = user)]
 pub struct User {
@@ -187,7 +197,7 @@ public static partial class Module
 <TabItem value="rust" label="Rust">
 
 ```rust
-use spacetimedb::{table, reducer, ReducerContext, Identity};
+use spacetimedb::{table, reducer, ReducerContext, Identity, Table};
 
 #[table(accessor = player)]
 pub struct Player {

docs/docs/00200-core-concepts/00200-functions/00400-procedures.md

@@ -891,7 +891,7 @@ Procedures can call reducers by invoking them within a transaction block. The re
 
 ```typescript
 // Define a reducer and save the reference
-const processItem = spacetimedb.reducer('process_item', { itemId: t.u64() }, (ctx, { itemId }) => {
+export const processItem = spacetimedb.reducer({ itemId: t.u64() }, (ctx, { itemId }) => {
   // ... reducer logic
 });
 

docs/docs/00200-core-concepts/00300-tables.md

@@ -106,7 +106,7 @@ Tables are defined in your module code with a name, columns, and optional config
 Use the `table` function to declare a new table:
 
 ```typescript
-import { table, t } from 'spacetimedb/server';
+import { schema, table, t } from 'spacetimedb/server';
 
 const people = table(
   { name: 'people', public: true },
@@ -116,9 +116,12 @@ const people = table(
     email: t.string().unique(),
   }
 );
+
+const spacetimedb = schema({ people });
+export default spacetimedb;
 ```
 
-The first argument defines table options, and the second defines columns.
+The first argument to `table()` defines table options, and the second defines columns. Pass your tables to `schema()` as an object: `schema({ people })` or `schema({ table1, table2 })`. Never use `schema(table)` or `schema(t1, t2, t3)`.
 
 </TabItem>
 <TabItem value="csharp" label="C#">
@@ -188,9 +191,29 @@ FIELD_Unique(person, email)
 </TabItem>
 </Tabs>
 
+### Creating the schema (TypeScript)
+
+After defining tables, pass them to `schema()` as a single object. The object keys become the accessor names in `ctx.db`:
+
+```typescript
+const people = table({ name: 'people', public: true }, { /* columns */ });
+const products = table({ name: 'products', public: true }, { /* columns */ });
+
+const spacetimedb = schema({ people, products });
+export default spacetimedb;
+```
+
+Use `schema({ table1 })` or `schema({ t1, t2 })`. Never use `schema(table)` or `schema(t1, t2, t3)`.
+
+For a compact list of TypeScript gotchas, see the [cheat sheet](./00100-databases/00500-cheat-sheet.md#common-mistakes).
+
 ## Table Naming and Accessors
 
-The table name you specify determines how you access the table in your code. Understanding this relationship is essential for writing correct SpacetimeDB modules.
+The table name you specify determines how you access the table in your code and in SQL. Understanding this relationship is essential for writing correct SpacetimeDB modules.
+
+:::note Table names in SQL
+The table `name` in your schema is used **verbatim** in SQL queries and subscriptions. There is no automatic pluralization or case conversion. If you define `name: 'position'`, SQL uses `position`; if you define `name: 'positions'`, SQL uses `positions`. Ensure your schema names match what your SQL queries expect.
+:::
 
 ### How Accessor Names Are Derived
 
@@ -219,25 +242,29 @@ ctx.db.playerScores.insert({ /* ... */ });
 </TabItem>
 <TabItem value="csharp" label="C#">
 
-The accessor name **exactly matches** the `Name` attribute value:
+The accessor name **exactly matches** the `Accessor` attribute value:
 
 ```csharp
 // Table definition
 [SpacetimeDB.Table(Accessor = "Player", Public = true)]
 public partial struct Player { /* columns */ }
 
-// Accessor matches Name exactly
+// Accessor matches Accessor value exactly
 ctx.Db.Player.Insert(new Player { /* ... */ });
 ```
 
-| Name Attribute | Accessor |
-|----------------|----------|
-| `Name = "User"` | `ctx.Db.User` |
-| `Name = "Player"` | `ctx.Db.Player` |
-| `Name = "GameSession"` | `ctx.Db.GameSession` |
+| Accessor | API Accessor | SQL Table Name (when Name omitted) |
+|----------|---------------|-------------------------------------|
+| `"User"` | `ctx.Db.User` | `User` |
+| `"Player"` | `ctx.Db.Player` | `Player` |
+| `"GameSession"` | `ctx.Db.GameSession` | `GameSession` |
 
 :::warning Case Sensitivity
-The accessor is case-sensitive and must match the `Name` value exactly. `Name = "user"` produces `ctx.Db.user`, not `ctx.Db.User`.
+The accessor is case-sensitive and must match the `Accessor` value exactly. `Accessor = "user"` produces `ctx.Db.user`, not `ctx.Db.User`.
+:::
+
+:::tip C# Convention
+Pick a stable accessor style for your project and use it consistently (for example, `User`, `user`, or `player_score`). Accessor names are case-sensitive.
 :::
 
 </TabItem>

docs/docs/00200-core-concepts/00300-tables/00200-column-types.md

@@ -79,7 +79,7 @@ These optimizations apply across all supported languages.
 | Primitive | `t.u128()` | `bigint` | Unsigned 128-bit integer |
 | Primitive | `t.i256()` | `bigint` | Signed 256-bit integer |
 | Primitive | `t.u256()` | `bigint` | Unsigned 256-bit integer |
-| Composite | `t.object(name, obj)` | `{ [K in keyof Obj]: T<Obj[K]> }` | Product/object type for nested data |
+| Composite | `t.object(name, obj)` | `{ [K in keyof Obj]: T<Obj[K]> }` | Product/object type for nested data. Use `t.object`, not `t.struct` (which does not exist). |
 | Composite | `t.enum(name, variants)` | `{ tag: 'variant' } \| { tag: 'variant', value: T }` | Sum/enum type (tagged union) |
 | Composite | `t.array(element)` | `T<Element>[]` | Array of elements |
 | Composite | `t.option(value)` | `Value \| undefined` | Optional value |
@@ -229,7 +229,7 @@ public static partial class Module
         public double Z;
     }
 
-    // Define an enum for status
+    // Define an enum for status (must be partial record, not partial class)
     [SpacetimeDB.Type]
     public partial record Status : TaggedEnum<(
         Unit Active,

docs/docs/00200-core-concepts/00300-tables/00230-auto-increment.md

@@ -35,7 +35,7 @@ export const add_post = spacetimedb.reducer({ title: t.string() }, (ctx, { title
 });
 ```
 
-Use the `.autoInc()` method on a column builder.
+Use the `.autoInc()` method on a column builder (not `autoIncrement`, which does not exist).
 
 Auto-increment columns must be integer types: `t.i8()`, `t.u8()`, `t.i16()`, `t.u16()`, `t.i32()`, `t.u32()`, `t.i64()`, `t.u64()`, `t.i128()`, `t.u128()`, `t.i256()`, or `t.u256()`.
 
@@ -198,7 +198,7 @@ export const insert_user = spacetimedb.reducer({ name: t.string() }, (ctx, { nam
 ```csharp
 public partial class Module
 {
-    [SpacetimeDB.Table(Accessor = "user", Public = true)]
+    [SpacetimeDB.Table(Accessor = "User", Public = true)]
     public partial struct User
     {
         [SpacetimeDB.AutoInc]
@@ -217,6 +217,8 @@ public partial class Module
 <TabItem value="rust" label="Rust">
 
 ```rust
+use spacetimedb::{ReducerContext, Table};
+
 #[spacetimedb::table(accessor = user, public)]
 pub struct User {
     #[auto_inc]