Skip to content

docs: add description frontmatter to 12 pages - #398

Closed
laserduor wants to merge 1 commit into
bytebase:mainfrom
laserduor:docs/frontmatter-descriptions
Closed

docs: add description frontmatter to 12 pages#398
laserduor wants to merge 1 commit into
bytebase:mainfrom
laserduor:docs/frontmatter-descriptions

Conversation

@laserduor

Copy link
Copy Markdown
Contributor

Summary

Add a one-line description to the frontmatter of 12 pages that currently only have a title.

Why

Mintlify surfaces the frontmatter description in:

  • Search results — pages without a description render incomplete/blank entries
  • Link previews — shared doc links show no snippet

Each page gets a concise description matching its existing content. One line per file, no content changes.

Files

docs/index.mdx, docs/installation.mdx, docs/quickstart.mdx, docs/tools/overview.mdx, docs/tools/execute-sql.mdx, docs/tools/search-objects.mdx, docs/tools/explain-sql.mdx, docs/tools/health-check.mdx, docs/tools/custom-tools.mdx, docs/config/command-line.mdx, docs/config/toml.mdx, docs/config/debug.mdx

12 files, +12 lines, docs-only.

Mintlify surfaces the frontmatter description in search results and
link previews. Pages with only a title render incomplete entries in
search. Add a one-line description to every page that lacked one.
@tianzhou

tianzhou commented Aug 8, 2026

Copy link
Copy Markdown
Member

This is intentional, otherwise, mintlify will render it below the title, which is duplicated info.

@tianzhou tianzhou closed this Aug 8, 2026
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