Skip to content

docs: Add AI Integration page and Copy Markdown chip - #228

Merged
jungpaeng merged 6 commits into
toss:mainfrom
qkraudghgh:docs/add-ask-ai-dropdown
Jun 4, 2026
Merged

jungpaeng merged 6 commits into
toss:mainfrom
qkraudghgh:docs/add-ask-ai-dropdown

Conversation

@qkraudghgh

@qkraudghgh qkraudghgh commented Jun 4, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Surface an AI-friendly entry point in the docs.

  • New sidebar group Documentation > AI for Agents (한국어: AI 에이전트용) with a single page that documents the existing /llms.txt, /llms-full.txt, /ai.txt endpoints already shipping under /public/. The page follows es-toolkit's AI Integration layout and uses the docs' usual ~해요 voice in Korean.
  • Copy Markdown chip in the top-right of every /docs and /api page:
    • Left click fetches the page's raw .mdx from raw.githubusercontent.com and copies it to the clipboard — no build pipeline required.
    • Caret opens a dropdown with Open in ChatGPT / Open in Claude, each launching the assistant pre-filled with Read <page-url>, I want to ask questions about it.
    • Uses the official OpenAI monoblossom and Claude wordmark glyphs as inline SVG with fill="currentColor", so light/dark themes flow through naturally.
    • Hidden on landing pages, shown only on real documentation pages.

Screenshots

Copy Markdown chip (closed)

Copy Markdown chip closed

Copy Markdown chip (dropdown open)

Copy Markdown chip open

AI Integration page (English)

AI Integration en

AI 통합 page (Korean)

AI Integration ko

Test plan

  • yarn lint passes
  • Copy Markdown chip appears on /docs/* and /api/*, hidden on landing pages
  • Left click copies the current page's .mdx to the clipboard
  • ChatGPT and Claude shortcuts open with the page URL pre-filled
  • AI for Agents > LLMs.txt renders in both English and Korean

qkraudghgh and others added 6 commits June 4, 2026 16:39
Add a small dropdown in the top-right of every /docs and /api page
that opens the current page in ChatGPT or Claude pre-filled with
"Read <page-url>, I want to ask questions about it.".

Also add a Guides > LLMs.txt page (en + ko) that documents the
existing /llms.txt, /llms-full.txt, /ai.txt endpoints and how to
use them from assistants.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Switch the top-right chip on /docs and /api pages to a split button:
- left click fetches the page's raw .mdx from raw.githubusercontent.com
  and copies it to the clipboard (no build pipeline required)
- caret opens the existing ChatGPT / Claude shortcuts dropdown

Update the LLMs.txt guide (en + ko) to describe both actions.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Replace the placeholder geometric icons with the actual OpenAI
monoblossom and Claude wordmark glyphs as inline SVG paths.
Both use fill="currentColor" so the theme's light/dark colors flow
through naturally.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Trim the OpenAI SVG viewBox to the path's bounding box so it renders
at the same visual size as the Claude glyph.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- Add docs sidebar group "AI for Agents" (en) / "AI 에이전트용" (ko)
  alongside the existing Guides and Learn More groups
- Move llms-txt.mdx from Guides to the new group
- Rewrite the page: H1 is now "AI Integration" / "AI 통합", drop the
  License and Cursor/VS Code stub sections, split ChatGPT and Claude
  into their own headers, and add a leading positioning line about
  grounding agents in the real API surface
- Clarify that /llms.txt, /llms-full.txt, /ai.txt are English-only
  and that per-page Markdown in either language comes from the
  Copy Markdown button

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Restructure the page to mirror es-toolkit's AI integration layout:
each endpoint gets its own H3, the page closes with a "Using these
endpoints" subsection that shows a one-line prompt example.

Use the friendlier "~해요" style in the Korean copy to match the
rest of the docs and not sound machine-generated.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@qkraudghgh
qkraudghgh requested a review from jungpaeng as a code owner June 4, 2026 08:48
@vercel

vercel Bot commented Jun 4, 2026

Copy link
Copy Markdown

@qkraudghgh is attempting to deploy a commit to the Toss Team on Vercel.

A member of the Team first needs to authorize it.

@changeset-bot

changeset-bot Bot commented Jun 4, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 2782763

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@codecov-commenter

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.85%. Comparing base (c7324a8) to head (2782763).

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff           @@
##             main     #228   +/-   ##
=======================================
  Coverage   99.85%   99.85%           
=======================================
  Files          15       15           
  Lines        1340     1340           
  Branches      262      262           
=======================================
  Hits         1338     1338           
  Misses          2        2           
Components Coverage Δ
overlay-kit 99.85% <ø> (ø)
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@jungpaeng
jungpaeng merged commit 8f0e59c into toss:main Jun 4, 2026
9 of 10 checks 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.

3 participants