Skip to content

Add docs/content dogfood workspace setup #1757

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
3mdistal wants to merge 6 commits into from
Closed

Add docs/content dogfood workspace setup #1757

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
2add79e
feat(content): add docs dogfood workspace action
3mdistal Jul 1, 2026
b132a74
Merge remote-tracking branch 'origin/main' into codex/docs-content-do…
3mdistal Jul 1, 2026
4158da7
chore(content): format agent guide after merge
3mdistal Jul 1, 2026
017278d
fix(content): harden dogfood workspace reruns
3mdistal Jul 6, 2026
25acf62
Merge remote-tracking branch 'origin/main' into codex/docs-content-do…
3mdistal Jul 7, 2026
dbd012a
Merge remote-tracking branch 'origin/main' into codex/docs-content-do…
3mdistal Jul 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions packages/core/docs/content/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -72,13 +72,13 @@ const responseChartResultSchema = z.object({

export default defineAction({
description: "Analyze recent form responses and render a custom chart.",
schema: z.object({
formId: z.string().default("demo")
schema: z.object({
formId: z.string().default("demo")
}),
outputSchema: responseChartResultSchema,
chatUI: {
renderer: "responses.response-chart",
title: "Response chart"
chatUI: {
renderer: "responses.response-chart",
title: "Response chart"
},
readOnly: true,
run: async ({ formId }) => ({
Expand Down
10 changes: 5 additions & 5 deletions packages/core/docs/content/locales/ar-SA/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,13 @@ const responseChartResultSchema = z.object({

export default defineAction({
description: "Analyze recent form responses and render a custom chart.",
schema: z.object({
formId: z.string().default("demo")
schema: z.object({
formId: z.string().default("demo")
}),
outputSchema: responseChartResultSchema,
chatUI: {
renderer: "responses.response-chart",
title: "مخطط الردود"
chatUI: {
renderer: "responses.response-chart",
title: "مخطط الردود"
},
readOnly: true,
run: async ({ formId }) => ({
Expand Down
10 changes: 5 additions & 5 deletions packages/core/docs/content/locales/de-DE/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,13 @@ const responseChartResultSchema = z.object({

export default defineAction({
description: "Analyze recent form responses and render a custom chart.",
schema: z.object({
formId: z.string().default("demo")
schema: z.object({
formId: z.string().default("demo")
}),
outputSchema: responseChartResultSchema,
chatUI: {
renderer: "responses.response-chart",
title: "Antwortdiagramm"
chatUI: {
renderer: "responses.response-chart",
title: "Antwortdiagramm"
},
readOnly: true,
run: async ({ formId }) => ({
Expand Down
10 changes: 5 additions & 5 deletions packages/core/docs/content/locales/es-ES/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,13 @@ const responseChartResultSchema = z.object({

export default defineAction({
description: "Analyze recent form responses and render a custom chart.",
schema: z.object({
formId: z.string().default("demo")
schema: z.object({
formId: z.string().default("demo")
}),
outputSchema: responseChartResultSchema,
chatUI: {
renderer: "responses.response-chart",
title: "Gráfico de respuestas"
chatUI: {
renderer: "responses.response-chart",
title: "Gráfico de respuestas"
},
readOnly: true,
run: async ({ formId }) => ({
Expand Down
10 changes: 5 additions & 5 deletions packages/core/docs/content/locales/fr-FR/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,13 @@ const responseChartResultSchema = z.object({

export default defineAction({
description: "Analyze recent form responses and render a custom chart.",
schema: z.object({
formId: z.string().default("demo")
schema: z.object({
formId: z.string().default("demo")
}),
outputSchema: responseChartResultSchema,
chatUI: {
renderer: "responses.response-chart",
title: "Graphique des réponses"
chatUI: {
renderer: "responses.response-chart",
title: "Graphique des réponses"
},
readOnly: true,
run: async ({ formId }) => ({
Expand Down
10 changes: 5 additions & 5 deletions packages/core/docs/content/locales/hi-IN/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,13 @@ const responseChartResultSchema = z.object({

export default defineAction({
description: "Analyze recent form responses and render a custom chart.",
schema: z.object({
formId: z.string().default("demo")
schema: z.object({
formId: z.string().default("demo")
}),
outputSchema: responseChartResultSchema,
chatUI: {
renderer: "responses.response-chart",
title: "प्रतिक्रिया चार्ट"
chatUI: {
renderer: "responses.response-chart",
title: "प्रतिक्रिया चार्ट"
},
readOnly: true,
run: async ({ formId }) => ({
Expand Down
10 changes: 5 additions & 5 deletions packages/core/docs/content/locales/ja-JP/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,13 @@ const responseChartResultSchema = z.object({

export default defineAction({
description: "Analyze recent form responses and render a custom chart.",
schema: z.object({
formId: z.string().default("demo")
schema: z.object({
formId: z.string().default("demo")
}),
outputSchema: responseChartResultSchema,
chatUI: {
renderer: "responses.response-chart",
title: "回答チャート"
chatUI: {
renderer: "responses.response-chart",
title: "回答チャート"
},
readOnly: true,
run: async ({ formId }) => ({
Expand Down
10 changes: 5 additions & 5 deletions packages/core/docs/content/locales/ko-KR/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,13 @@ const responseChartResultSchema = z.object({

export default defineAction({
description: "Analyze recent form responses and render a custom chart.",
schema: z.object({
formId: z.string().default("demo")
schema: z.object({
formId: z.string().default("demo")
}),
outputSchema: responseChartResultSchema,
chatUI: {
renderer: "responses.response-chart",
title: "응답 차트"
chatUI: {
renderer: "responses.response-chart",
title: "응답 차트"
},
readOnly: true,
run: async ({ formId }) => ({
Expand Down
10 changes: 5 additions & 5 deletions packages/core/docs/content/locales/pt-BR/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,13 @@ const responseChartResultSchema = z.object({

export default defineAction({
description: "Analyze recent form responses and render a custom chart.",
schema: z.object({
formId: z.string().default("demo")
schema: z.object({
formId: z.string().default("demo")
}),
outputSchema: responseChartResultSchema,
chatUI: {
renderer: "responses.response-chart",
title: "Gráfico de respostas"
chatUI: {
renderer: "responses.response-chart",
title: "Gráfico de respostas"
},
readOnly: true,
run: async ({ formId }) => ({
Expand Down
10 changes: 5 additions & 5 deletions packages/core/docs/content/locales/zh-CN/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,13 +55,13 @@ const responseChartResultSchema = z.object({

export default defineAction({
description: "Analyze recent form responses and render a custom chart.",
schema: z.object({
formId: z.string().default("demo")
schema: z.object({
formId: z.string().default("demo")
}),
outputSchema: responseChartResultSchema,
chatUI: {
renderer: "responses.response-chart",
title: "回复图表"
chatUI: {
renderer: "responses.response-chart",
title: "回复图表"
},
readOnly: true,
run: async ({ formId }) => ({
Expand Down
10 changes: 5 additions & 5 deletions packages/core/docs/content/locales/zh-TW/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,13 +53,13 @@ const responseChartResultSchema = z.object({

export default defineAction({
description: "Analyze recent form responses and render a custom chart.",
schema: z.object({
formId: z.string().default("demo")
schema: z.object({
formId: z.string().default("demo")
}),
outputSchema: responseChartResultSchema,
chatUI: {
renderer: "responses.response-chart",
title: "回覆圖表"
chatUI: {
renderer: "responses.response-chart",
title: "回覆圖表"
},
readOnly: true,
run: async ({ formId }) => ({
Expand Down
14 changes: 14 additions & 0 deletions templates/content/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,7 @@ cd templates/content && pnpm action <name> [args]
| `list-local-component-files` | | List registered local MDX component source files |
| `write-local-component-file` | `--workspaceId <id> --path <relative-component-path> --content <source>` | Create or update a file in a registered local `components/` folder |
| `create-content-database` | `[--documentId <id>] [--parentId <id>] [--title <text>]` | Create a database page or convert an existing page into a database |
| `configure-docs-content-dogfood-workspace` | `[--databaseId <id>] [--documentId <id>] [--title <text>] [--updateRowStatusFields true\|false]` | Create or upgrade the internal Builder docs/blog dogfood workspace with operations fields, source status fields, saved views, and row status backfill |
| `create-inline-content-database` | `--hostDocumentId <id> [--title <text>]` | Create a database owned by an inline database block in the host document |
| `get-content-database` | `--databaseId <id>` or `--documentId <id>` | Get a database table with property schema and item pages |
| `list-trashed-content-databases` | | List soft-deleted databases visible in the sidebar Trash surface |
Expand Down Expand Up @@ -587,6 +588,7 @@ multi-select, users can add a new board group from the board itself; this
appends a new option to the grouped property definition.
Use
`create-content-database`, `create-inline-content-database`,
`configure-docs-content-dogfood-workspace`,
`get-content-database`, `list-trashed-content-databases`,
`restore-content-database`, `add-database-item`, `duplicate-database-item`,
`duplicate-database-items`, `delete-database-items`, `move-database-item`,
Expand All @@ -599,6 +601,18 @@ When targeting more than one database row, call `duplicate-database-items` or
`documentIds`. Do not loop `duplicate-database-item` or `delete-document` for
multi-row duplicate/delete requests.

For Builder docs/blog internal dogfooding, prefer
`configure-docs-content-dogfood-workspace` over manually creating the same
fields and views. It creates or upgrades a practical content-operations
workspace with persona, topic, use case, SEO angle, owner, source status,
safe-to-edit, needs-review, and unsupported-block fields. The action can
backfill row status fields from the current Builder source snapshot and saved
change-set/body hydration signals. Treat source status, safe-to-edit,
needs-review, unsupported blocks, and unsupported block notes as derived fields
when `updateRowStatusFields` is enabled; rerunning the action refreshes them
from source state. The action does not imply the separate scale, bulk-update, or
source-component mapping lanes have landed.

## UI Components

**Always use shadcn/ui components** from `app/components/ui/` for all standard UI patterns (dialogs, popovers, dropdowns, tooltips, buttons, etc). Never build custom modals or dropdowns with absolute/fixed positioning — use the shadcn primitives instead.
Expand Down
Loading
Loading