Skip to content

docs: terminology rebrands and content freshness fixes#120

Open
philip wants to merge 6 commits into
mainfrom
docs/terminology-and-freshness
Open

docs: terminology rebrands and content freshness fixes#120
philip wants to merge 6 commits into
mainfrom
docs/terminology-and-freshness

Conversation

@philip

@philip philip commented Jul 10, 2026

Copy link
Copy Markdown
Collaborator

Updates DevHub docs to current Databricks terminology and fixes outdated content found while auditing against canonical docs and the databricks CLI.

Rebrands (prose only; code identifiers like genie-space / GENIE_SPACE_ID left literal)

  • Genie space → Genie Agent
  • AI Gateway → Unity AI Gateway (legacy per-endpoint feature keeps "AI Gateway")
  • Multi-Agent Supervisor / ABMAS → Supervisor Agent

Accuracy fixes (verified vs canonical docs + CLI v1.1.0)

  • Lakebase: autoscaling up to 64 CU (128 GB); scale-to-zero default 24h (60s–7d); production branch scale-to-zero enabled by default
  • Apps: compute size via --compute-size; postgres.project required in apps init --set; document --replace-existing / --purge branch flags
  • Agent skills: full 32-skill table; correct databricks aitools list command
  • Fix dead links/anchors (agents namespace, #app-sharing, model-serving plugin, ai-gateway model services / ucode)
  • Clarify custom agents: calling an endpoint vs the Agent-on-Apps (agents plugin) path

Tests

  • docs-verify scaffold: add postgres.project, accept CLI v1.x
  • e2e page titles updated for renamed pages

Also ran prettier on 4 pre-existing unformatted files to pass the format check.

Additional changes (extends the above)

  • Extend the Genie Agents rebrand across the remaining recipes, cookbooks, examples, intent files, the shared replit preamble, and the agents docs (incl. the "Genie Multi-Agent Selector" template rename). Prose only; identifiers unchanged.
  • Rename the AI Gateway service facet to Unity AI Gateway in the templates catalog and reframe the foundation-model recipes/examples off "AI Gateway" to Model Serving / foundation-model endpoints (serving-endpoint "AI Gateway governance" feature name kept).
  • fix: the docs "Copy link" heading button now only shows "Copied" when the clipboard write actually succeeds (src/components/docs/content-heading.tsx).
  • Update the llms.txt generator's Agent Bricks section copy to match the renamed pages (plugins/llms-txt.ts).

Deferred to a follow-up PR

  • The Genie Agents / Unity AI Gateway rename across content/perspectives/** (~57 SEO pages) is intentionally left out of this PR to keep it reviewable, and will land in a separate follow-up.

The original commit and description were written by Isaac; the additional changes above were made in a follow-up.

Rebrand to current terminology (prose only, code identifiers left literal):
Genie space → Genie Agent, AI Gateway → Unity AI Gateway, Multi-Agent
Supervisor → Supervisor Agent.

Fix stale content verified against canonical docs and the databricks CLI:
- Lakebase autoscaling (up to 64 CU) and scale-to-zero defaults (24h, 60s-7d)
- apps --compute-size, postgres.project in 'apps init', --replace-existing/--purge
- full agent-skills table and correct 'aitools list' command
- dead links/anchors; custom-agents endpoint vs Agent-on-Apps clarification

Update docs-verify scaffold test and e2e page titles to match.
Also run prettier on 4 pre-existing unformatted files to satisfy the
format check.

Co-authored-by: Isaac
@philip philip requested a review from thisistonydang July 10, 2026 21:47
@thisistonydang thisistonydang force-pushed the docs/terminology-and-freshness branch from 05429a5 to 23363ba Compare July 11, 2026 01:59
copyText now returns a boolean and the heading button only enters the
success state when the clipboard write actually succeeds. Previously it
showed "Copied" even when the copy silently failed.
Note in the custom-agents setup table that deploying via agents.deploy()
is a legacy path (prefer the agents plugin on Apps).
Rename "Genie spaces" -> "Genie Agents" and "AI Gateway" -> "Unity AI Gateway"
in the Agent Bricks section description that summarizes the renamed pages.
Apply the July 2026 Databricks rebrand (Genie Spaces -> Genie Agents)
across recipes, cookbooks, examples, intent files, dev guidelines, the
shared replit preamble, and the agents docs, including the "Genie
Multi-Agent Selector" template rename and the single-agent wording.
Prose only; genie_space_id / DATABRICKS_GENIE_SPACE_ID / /genie/spaces /
genie list-spaces and the genie-multi-space slug are unchanged.
…ation-model recipes

Rename the AI Gateway service facet to Unity AI Gateway in recipes.ts
(and the e2e service filter), and reframe the foundation-model recipes
and example goals off "AI Gateway" to Model Serving / foundation-model
endpoints (keeping the serving-endpoint "AI Gateway governance" feature
name). Update the e2e tests to match the renamed recipe titles and slug.
@thisistonydang thisistonydang force-pushed the docs/terminology-and-freshness branch from 23363ba to ad0f196 Compare July 11, 2026 02:58
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