Skip to content

docs: replace single-tab code block title with bolded label on BYOLLM page#44

Merged
hongyi-chen merged 1 commit into
mainfrom
hongyi/fix-byollm-code-block-title
May 9, 2026
Merged

docs: replace single-tab code block title with bolded label on BYOLLM page#44
hongyi-chen merged 1 commit into
mainfrom
hongyi/fix-byollm-code-block-title

Conversation

@hongyi-chen
Copy link
Copy Markdown
Collaborator

Summary

The Step 2 IAM policy code block on the Bring your own LLM page used a title="Example: AWS Bedrock minimum IAM policy" attribute, which Astro Starlight's Expressive Code renders as a single tab on top of the block. That looked like a vestigial tab strip rather than a label.

The style guide in AGENTS.md reserves the title= fence attribute for actual filenames (e.g., ```yaml title="config.yaml"), so using it for free-form descriptive text was off-pattern. A repo-wide grep for ^```[a-z]* title= confirmed this was the only occurrence in src/content/.

Changes

src/content/docs/enterprise/enterprise-features/bring-your-own-llm.mdx

  • Dropped the title= attribute from the JSON IAM-policy fence in the Step 2: Provision IAM roles (cloud admin) section.
  • Added a **Example: AWS Bedrock minimum IAM policy** bolded label line directly above the fence instead.

Validation

  • npm run build succeeds for the route that includes this page (/_llms-txt/enterprise.txt).
  • The pre-existing RangeError on /_llms-txt/support.txt reproduces on clean main; it is unrelated to this change.

Artifacts

Co-Authored-By: Oz oz-agent@warp.dev

The Step 2 IAM policy code block on the Bring your own LLM page used a
title= attribute, which Astro Starlight renders as a single tab on top
of the code block. The style guide reserves title= for actual filenames
(e.g., title="config.yaml"), so this off-pattern usage looked like a
vestigial tab strip.

Drop the title attribute and add a bolded label line above the fence
instead. Repo-wide audit confirmed this was the only occurrence.

Co-Authored-By: Oz <oz-agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label May 8, 2026
@vercel
Copy link
Copy Markdown

vercel Bot commented May 8, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 8, 2026 9:47pm

Request Review

@hongyi-chen hongyi-chen merged commit c2922c5 into main May 9, 2026
8 of 9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants