Skip to content

docs: three-audience documentation — Use section, builder deep-dives, admin guides#41

Merged
os-zhuang merged 3 commits into
mainfrom
claude/session-uty9w1
Jul 17, 2026
Merged

docs: three-audience documentation — Use section, builder deep-dives, admin guides#41
os-zhuang merged 3 commits into
mainfrom
claude/session-uty9w1

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

What

Completes the core-feature documentation effort started in #40 by covering all three audiences of the docs site with 26 new English pages:

🧑‍💼 End users — new top-level Use section (7 pages)

use/ — Using ObjectOS (console tour), Working with records, Using views, Dashboards, Approvals, Notifications, Profile & settings.
Every fact was verified by driving the real Console in a browser (showcase example app, @objectstack/console 15.1.1): view-type switcher (Grid/Kanban/Gallery/Calendar/Timeline/Gantt), state pipeline bar, approval inbox tabs (My Pending / I Submitted / Completed / All), notification inbox columns, profile/security surfaces, avatar-menu Theme/Language. Unverified behaviors were deliberately left out.

🛠 Builders — Build section deep-dives (14 pages)

  • build/data/ — Relationships, Formulas, Validation Rules
  • build/interface/ — section landing, Apps & navigation, Forms, Dashboards, Pages
  • build/automation/ — section landing (flow vs workflow vs approval chooser), Workflows (state machines), Approvals

🔐 Administrators — Configure expansion (5 pages)

  • configure/index — Administration landing: Setup console tour + task→doc map
  • configure/users — business units, invitations, teams, service accounts & API keys
  • configure/permissions/managing-access — onboard / change role / verify / offboard recipes
  • configure/permissions/field-level-security
  • configure/mcp — connect Claude & other AI tools via MCP

Navigation

  • Landing page gains a "Find your docs" three-audience directory
  • Root sidebar ordered by role: Use → Build → Configure → Deploy → Operate
  • All sidebar meta.json files updated across the 7 locales (arrays mirrored; group titles localized; no translation content stubs, per AGENTS.md — locales fall back to English)

Fact sources

Builder/admin pages are rewritten for this site from the corresponding ObjectStack framework docs (objectstack-ai/framework content/docs/); Use pages from live browser verification. English only — translations follow via the normal sync pass.

Verification

  • npm run type-check and npm run build pass (704 static pages)
  • All 26 new URLs return 200 on a production build; /docs/build/{data-model,views,actions,flows} still 308-redirect correctly
  • Browser-checked: Use section sidebar, Configure ordering, zh-Hans fallback of new pages
  • Internal-link audit: no links to nonexistent pages

🤖 Generated with Claude Code

https://claude.ai/code/session_0145MY7RdJr8KuRMyn5oKAR6


Generated by Claude Code

claude added 3 commits July 17, 2026 12:35
New Build-section pages covering the core-feature gaps against the
ObjectStack framework docs: relationships, formulas, validation rules;
interface landing, apps & navigation, forms, dashboards, custom pages;
automation landing, state-machine workflows, and approval processes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0145MY7RdJr8KuRMyn5oKAR6
…management

New Configure pages: Administration landing (Setup console tour and
task map), Users & Organization (business units, invitations, teams,
service accounts), Managing Access (onboarding/offboarding recipes),
Field-Level Security, and Connect AI tools via MCP. Sidebar metas
updated across all locales.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0145MY7RdJr8KuRMyn5oKAR6
New top-level Use section for everyday users: console tour, working
with records, views, dashboards, approvals, notifications, and
profile/settings. Content was verified by driving the showcase app's
Console in a browser. Landing page gains a three-audience directory
(use / build / administer) and the sidebar orders sections by role.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0145MY7RdJr8KuRMyn5oKAR6
@os-zhuang
os-zhuang merged commit 38bbdc6 into main Jul 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants