Skip to content

docs: reframe AI Studio messaging and add AI audience cards - #832

Merged
theekrystallee merged 4 commits into
mainfrom
docs/828-ai-studio-messaging
Nov 6, 2026
Merged

theekrystallee merged 4 commits into
mainfrom
docs/828-ai-studio-messaging

Conversation

@theekrystallee

Copy link
Copy Markdown
Member

summary

reframes Hedera AI Studio as "open source tools for AI agents and agentic commerce" (replacing "open-source toolkit"), reorganizes and fixes the AI Studio landing page, and adds two AI audience cards to the home page.

solutions/ai/index.mdx (AI Studio landing page)

  • description and intro: lead with the new tagline. the intro links every key component (Hedera Agent Kit, Agent Lab, Agent Builder, Network MCP Server, and x402) and says what AI Studio agents do, with HCS and HTS spelled out on first mention.
  • "What you can do with AI Studio" (new): three cards, one per goal: build an agent (Agent Kit), connect an AI client (Network MCP Server), and send or accept agent payments (x402). each card says what the tool gives you, sourced from that tool's docs page.
  • "Get started": "Try the 60-second quickstart" now links to the docs JavaScript quickstart and also links the Python quickstart. it used to link to the GitHub examples file, which has no quickstart. a closing line points the other two goals to the Network MCP Server quickstart, Pay with x402, and Accept x402.
  • example agents list: the structured chat agent line now matches its source (it works like the tool-calling agent and needs LangChain v0.3). "tool-calling" and "human-in-the-loop" are hyphenated.
  • banner: the closed bounty is replaced with the Agentic Payments Partner Program sign-up, so the copy and CTA match.
  • removed:
    • the banner image. it read "Open-source toolkit bridging artificial intelligence and Hedera" and "Connect AI agents seamlessly". the file stays in images/ and is no longer used.
    • the "Key components" cards. the intro now links every component.
  • copy fixes: typos ("Theis", "laguage", "Whats New", "Github", and others), buzzwords ("intuitive", "minimal effort", "next generation"), and "developers" and "users" replaced with "you". headings are in sentence case.

solutions/index.mdx: the AI Studio and Agent Kit card descriptions use the new framing.

index.mdx (home): the AI Studio spotlight strip is replaced by two audience cards.

  • "Build AI agents": "Open source tools for AI agents and agentic commerce." it carries a Hedera AI Studio pill that links to the AI Studio page, and a "Build your first agent" button that links to the Agent Kit.
  • "Develop with AI": "Connect your AI coding assistant to the Docs MCP Server." both the card and its button link to the Docs MCP setup page.

style.css

  • new .ai-path card styles: reuse the AI Studio spotlight's surface, border, accent line, light-mode halo, and 2px hover lift, plus the existing landing tokens. nothing changes color on hover.
  • whole-card links: each card is clickable as a whole through a stretched link, and the pill keeps its own target. Mintlify's .link class sets position: relative and z-index: 10, so those are reset on the stretched link.
  • navbar button styles: were keyed on a[href*="hackathon"] and are now keyed on a[href*="mcp-setup"], so the new navbar button keeps the same look. only the navbar link matches.
  • cleanup: the unused .ai-spotlight* styles are removed, and the banner dot changes from pink to Cobalt (#2D84EB).

docs.json: the navbar "Join Hackathon" button (hedera.com/hackathon) becomes "Docs MCP" (robot icon) and links to /learn/getting-started/mcp-setup. no navigation or redirect changes.

support/glossary.mdx: new entries for Hedera Agent Kit, Hedera AI Studio, and x402. the x402 entry describes it as an open standard that AI Studio supports, not as part of AI Studio.

issues

refs #828

the copy, typo fixes, and audience cards are done. the open questions below are flagged, not resolved, so the issue stays open until the AI Studio owners answer them.

validation

  • mint broken-links --check-anchors: no new broken links or anchors. the one hit in a changed file (/networks/release-notes/services#v0.50 in the glossary) is in an entry that already exists on main.
  • no pages moved, renamed, or deleted, so no redirects are needed.
  • reference/ and networks/release-notes/ untouched.
  • docs.json is valid JSON.
  • terminology check word list: no matches in changed lines.
  • home, AI Studio, solutions, and glossary pages return HTTP 200 in the local preview, checked in light, dark, and 420px mobile.

- reframe AI Studio as open source tools for AI agents and agentic commerce
- restructure the AI Studio page: intro links each component, add "What you can do with AI Studio" cards, update get started and resources
- replace the closed bounty banner with the agentic payments partner program
- fix typos, buzzwords, and style guide issues; remove the old toolkit banner image
- replace the home page AI Studio spotlight with "Build AI agents" and "Develop with AI" cards
- point the navbar button to the Docs MCP setup page
- add glossary entries for Hedera Agent Kit, Hedera AI Studio, and x402

Refs #828

Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
@theekrystallee theekrystallee self-assigned this Nov 6, 2026
@theekrystallee
theekrystallee requested review from a team as code owners November 6, 2026 06:26
@mintlify

mintlify Bot commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
hedera-docs 🟢 Ready View Preview Nov 6, 2026, 8:50 PM

@theekrystallee

Copy link
Copy Markdown
Member Author

@walkerlj0 @LukeForrest-Hashgraph @narbs91 can i please get a review? thanks

Comment thread solutions/ai/index.mdx Resolved
@narbs91

narbs91 commented Nov 6, 2026

Copy link
Copy Markdown

@walkerlj0 @LukeForrest-Hashgraph @narbs91 can i please get a review? thanks

Took a look and reads well to me, just the one comment about Claude Desktop. Will leave the final say on approval to Luke and Lindsay

@jaycoolh
jaycoolh self-requested a review November 6, 2026 17:23

@walkerlj0 walkerlj0 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a few tweaks, otherwise looks good!

Comment thread solutions/ai/index.mdx Resolved
Comment thread index.mdx Resolved
Comment thread index.mdx Resolved
Comment thread index.mdx Resolved
Co-authored-by: Lindsay Walker <66978602+walkerlj0@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Co-authored-by: Lindsay Walker <66978602+walkerlj0@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>

@walkerlj0 walkerlj0 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@theekrystallee
theekrystallee merged commit c25677f into main Nov 6, 2026
18 checks passed
@theekrystallee
theekrystallee deleted the docs/828-ai-studio-messaging branch November 6, 2026 21:07

This branch was successfully deployed

1 active deployment
staging — a391f65b Deployed Nov 6, 2026 by mintlify[bot]
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.

3 participants