Files
SpacetimeDB/docs/llms/docs-benchmark-summary.json
Tyler Cloutier 73881e38f7 Further misc docs changes (#4029)
# Description of Changes

Major documentation overhaul focusing on tables, column types, and
indexes.

  **Quickstart Guides:**
- Updated React, TypeScript, Rust, and C# quickstarts with table/reducer
examples
  - Fixed CLI syntax (positional `--database` argument)
  - Improved template consistency across languages

  **Tables Documentation:**
- Added "Why Tables" section explaining table-oriented design philosophy
(tables as fundamental unit, system tables, data-oriented design
principles)
- Added "Physical and Logical Independence" section explaining how
subscription queries use the relational model independently of physical
storage
- Added brief sections linking to related pages (Visibility,
Constraints, Schedule Tables)
- Renamed "Scheduled Tables" to "Schedule Tables" throughout (tables
store schedules; reducers are scheduled)

  **Column Types:**
  - Split into dedicated page with unified type reference table
- Added "Representing Collections" section (Vec/Array vs table
tradeoffs)
  - Added "Binary Data and Files" section for Vec<u8> storage patterns
- Added "Type Performance" section (smaller types, fixed-size types,
column ordering for alignment)
  - Added complete example struct demonstrating all type categories
  - Renamed "Structured" category to "Composite"

  **Indexes:**
  - Complete rewrite with textbook-style documentation
  - Added "When to Use Indexes" guidance
- Documented single-column and multi-column index syntax (field-level
and table-level)
- Comprehensive range query examples with correct TypeScript `Range`
class syntax
  - Explained multi-column index prefix matching semantics
  - Added index-accelerated deletion examples
  - Included index design guidelines

  **Styling:**
  - Added CSS for table border radius and row separators
  - Created Check component for green checkmarks in tables

  # API and ABI breaking changes

  None. Documentation only.

  # Expected complexity level and risk

  1 - Documentation changes only, no code changes.

  # Testing

  - [ ] Verify docs build without errors
  - [ ] Review rendered pages for formatting issues
  - [ ] Confirm code examples are syntactically correct

---------

Signed-off-by: Tyler Cloutier <cloutiertyler@users.noreply.github.com>
Signed-off-by: John Detter <4099508+jdetter@users.noreply.github.com>
Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@users.noreply.github.com>
Co-authored-by: John Detter <4099508+jdetter@users.noreply.github.com>
2026-01-17 17:44:58 +00:00

80 lines
2.2 KiB
JSON

{
"version": 1,
"generated_at": "2026-01-17T02:44:26.905Z",
"by_language": {
"csharp": {
"modes": {
"docs": {
"hash": "7bd1056c239ec41df56d3be0edd5b7aac1c433acc3efbac0fe6f3b2a79ca2f1f",
"models": {
"GPT-5": {
"categories": {
"basics": {
"tasks": 12,
"total_tests": 27,
"passed_tests": 12,
"pass_pct": 44.444443,
"task_pass_equiv": 7.333334,
"task_pass_pct": 61.111115
},
"schema": {
"tasks": 10,
"total_tests": 34,
"passed_tests": 10,
"pass_pct": 29.411764,
"task_pass_equiv": 3.15,
"task_pass_pct": 31.5
}
},
"totals": {
"tasks": 22,
"total_tests": 61,
"passed_tests": 22,
"pass_pct": 36.065575,
"task_pass_equiv": 10.483333,
"task_pass_pct": 47.651512
}
}
}
}
}
},
"rust": {
"modes": {
"rustdoc_json": {
"hash": "40baf0d53a9de9eab21250fad1d96f530213fd7dd09cb9a3d97f40ff548f0d8a",
"models": {
"GPT-5": {
"categories": {
"basics": {
"tasks": 12,
"total_tests": 27,
"passed_tests": 25,
"pass_pct": 92.59259,
"task_pass_equiv": 10.0,
"task_pass_pct": 83.33333
},
"schema": {
"tasks": 10,
"total_tests": 34,
"passed_tests": 29,
"pass_pct": 85.29412,
"task_pass_equiv": 8.0,
"task_pass_pct": 80.0
}
},
"totals": {
"tasks": 22,
"total_tests": 61,
"passed_tests": 54,
"pass_pct": 88.52459,
"task_pass_equiv": 18.0,
"task_pass_pct": 81.818184
}
}
}
}
}
}
}
}