feat(docs): data-source / existing-system extension docs, homepage card, and blog#10
Merged
Conversation
Adds ko as the 7th supported locale, mirroring the ja/de/es/fr setup. - i18n: register 'ko'; LANGUAGE_NAMES '한국어'; nav labels (문서/다운로드/변경 내역) - middleware: map ko / ko-KR -> ko for browser language detection - 7 meta.ko.json sidebar files (구축/설정/권한/배포/운영/참조/리소스) - Full Korean translation of all 50 docs pages (*.ko.mdx) Translation prompt now enforces YAML-safe frontmatter (quote any title/ description containing a colon), preventing the build break fixed in 299b599. All 349 frontmatter blocks validate; type-check and docs build pass. UI strings in homepage-i18n/download-i18n fall back to English (same as ja/de/es/fr); legal pages (privacy/terms) fall back to English by design.
… blog
Add the "connect an existing business system, model its tables as objects,
and make it AI-native" story across docs, homepage, and a new blog.
Docs
- New reference page configure/data-sources.mdx: Datasource shape, shipped
drivers, defineStack({ datasources, datasourceMapping }), per-object
binding, capability-aware ObjectQL pushdown, AI uniform query. The
working "scan tables -> generate source-level objects" flow is documented
as using a coding agent (Claude Code) against the connected DB, in the
../hotcrm ObjectSchema.create shape. ADR-0015 federation is clearly
fenced as Roadmap (not shipped).
- New scenario page extend-existing-systems.mdx (sibling to why.mdx).
- Registered both in sidebar/root meta across all 7 locales.
- Full translations of both pages into zh-Hans, ja, de, es, fr, ko.
Homepage
- New lead feature card "Extend the Systems You Already Run" ->
/docs/configure/data-sources (Database icon).
- Populated homepage-i18n for ja, de, es, fr, ko (previously en/zh only).
Blog
- Wired i18n into the blog loader and route (locale-aware getPages/getPage,
generateParams, localized chrome + date locale + back link).
- Added Blog nav link across all 7 locales.
- First post extend-existing-systems-with-ai.mdx + 6 locale translations.
type-check and production build pass (509 static pages).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What & why
Adds the "connect an existing business system, model its tables as objects, and make it AI-native" story across docs, homepage, and a new blog — one of ObjectOS's most practical adoption paths.
Docs
configure/data-sources.mdx—Datasourceshape, the four shipped drivers,defineStack({ datasources, datasourceMapping }), per-objectdatasourcebinding, capability-aware ObjectQL pushdown, and AI uniform query. The working scan tables → generate source-level objects flow is documented as using a coding agent (Claude Code) against the connected DB, in the real../hotcrmObjectSchema.createshape.os datasource introspect).extend-existing-systems.mdx(sibling towhy.mdx).zh-Hans, ja, de, es, fr, ko.Homepage
/docs/configure/data-sources(Databaseicon).homepage-i18nforja, de, es, fr, ko(previously onlyen+zh-Hans).Blog (enabled)
getPages/getPage,generateParams, localized chrome, date locale, back link).extend-existing-systems-with-ai.mdxon this topic + 6 locale translations.Verification
pnpm --filter @objectos/docs type-check✅pnpm --filter @objectos/docs build✅ — 509 static pages, all locale + blog routes generate.Accuracy guardrails
English is the single source of truth (other locales derive). Only shipped datasource building blocks are documented as current; federation is roadmap. Credentials are env-based throughout; no secrets inlined.