Skip to content

new nav: refine descriptions in AI docs#22398

Merged
qiancai merged 11 commits intopingcap:feature/preview-top-navigationfrom
qiancai:refine-ai-docs
Feb 4, 2026
Merged

new nav: refine descriptions in AI docs#22398
qiancai merged 11 commits intopingcap:feature/preview-top-navigationfrom
qiancai:refine-ai-docs

Conversation

@qiancai
Copy link
Collaborator

@qiancai qiancai commented Feb 4, 2026

First-time contributors' checklist

What is changed, added or deleted? (Required)

Which TiDB version(s) do your changes apply to? (Required)

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions.

  • master (the latest development version)
  • v9.0 (TiDB 9.0 versions)
  • v8.5 (TiDB 8.5 versions)
  • v8.1 (TiDB 8.1 versions)
  • v7.5 (TiDB 7.5 versions)
  • v7.1 (TiDB 7.1 versions)
  • v6.5 (TiDB 6.5 versions)
  • v6.1 (TiDB 6.1 versions)
  • v5.4 (TiDB 5.4 versions)

What is the related PR or file link(s)?

  • This PR is translated from:
  • Other reference link(s):

Do your changes match any of the following descriptions?

  • Delete files
  • Change aliases
  • Need modification after applied to another branch
  • Might cause conflicts after applied to another branch

@ti-chi-bot ti-chi-bot bot added the missing-translation-status This PR does not have translation status info. label Feb 4, 2026
@ti-chi-bot
Copy link

ti-chi-bot bot commented Feb 4, 2026

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign hfxsd for approval. For more information see the Code Review Process.
Please ensure that each of them provides their approval before proceeding.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@ti-chi-bot ti-chi-bot bot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label Feb 4, 2026
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @qiancai, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request focuses on enhancing the user experience of the AI documentation by significantly improving its clarity, consistency, and accuracy. The changes aim to make the guides and examples easier to understand and follow, reducing potential confusion for users interacting with TiDB's AI features. By standardizing language and correcting minor issues, the documentation becomes a more reliable and accessible resource.

Highlights

  • Documentation Clarity and Consistency: Improved the clarity, conciseness, and consistency of descriptions across numerous AI-related documentation files. This includes refining introductory sentences, standardizing common phrases, and converting bulleted lists to numbered lists for better readability.
  • Standardized Prerequisites and Setup Instructions: Standardized the phrasing for prerequisites, such as TiDB Cloud Starter cluster creation and API key acquisition, and streamlined environment setup instructions across various example and integration guides.
  • Terminology Refinement: Updated terminology for consistency, such as changing 'Fulltext Search' to 'Full-Text Search' and 'HuggingFace' to 'Hugging Face' where appropriate.
  • Link Corrections: Fixed several duplicated or incorrect internal links, particularly those related to TiDB Cloud cluster tiers and vector search functions, ensuring accurate navigation within the documentation.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • ai/concepts/vector-search-overview.md
    • Removed a duplicated link for TiDB Cloud Starter cluster.
  • ai/examples/auto-embedding-with-pytidb.md
    • Refined introductory sentences for clarity.
    • Converted bullet points to numbered lists for better structure.
    • Standardized instructions for TiDB Cloud Starter cluster and environment setup.
  • ai/examples/basic-with-pytidb.md
    • Refined introductory sentences for clarity.
    • Converted bullet points to numbered lists for better structure.
    • Standardized instructions for TiDB Cloud Starter cluster and environment setup.
  • ai/examples/fulltext-search-with-pytidb.md
    • Changed 'Fulltext Search' to 'Full-Text Search' in the title and summary.
    • Refined introductory sentences for clarity.
    • Standardized instructions for TiDB Cloud Starter cluster and environment setup.
    • Corrected the cd command in step 1.
  • ai/examples/hybrid-search-with-pytidb.md
    • Changed 'fulltext search' to 'full-text search' in the summary.
    • Refined introductory sentences for clarity.
    • Standardized instructions for TiDB Cloud Starter cluster, OpenAI API key, and environment setup.
    • Clarified the note regarding full-text search region availability.
    • Improved phrasing for web UI access.
    • Corrected the cd command in step 1.
  • ai/examples/image-search-with-pytidb.md
    • Refined introductory sentences for clarity.
    • Converted bullet points to numbered lists for better structure.
    • Standardized instructions for TiDB Cloud Starter cluster and Jina AI API key.
    • Improved phrasing for environment setup, dataset description, and image search options.
  • ai/examples/memory-with-pytidb.md
    • Refined introductory sentences for clarity.
    • Converted bullet points to numbered lists for better structure.
    • Standardized instructions for TiDB Cloud Starter cluster and OpenAI API key.
    • Improved phrasing for environment setup, web application launch, command-line application launch, and web application UI description.
  • ai/examples/rag-with-pytidb.md
    • Refined introductory sentences for clarity.
    • Converted bullet points to numbered lists for better structure.
    • Standardized instructions for TiDB Cloud Starter cluster and Ollama.
    • Improved phrasing for API verification, environment setup, and troubleshooting.
  • ai/examples/text2sql-with-pytidb.md
    • Refined introductory sentences for clarity.
    • Standardized instructions for TiDB Cloud Starter cluster and OpenAI API key.
    • Improved phrasing for app usage and connection string example.
    • Corrected the cd command in step 1.
  • ai/examples/vector-search-with-pytidb.md
    • Refined introductory sentences for clarity.
    • Standardized instructions for TiDB Cloud Starter cluster and Ollama.
    • Improved phrasing for embedding service verification and environment setup.
  • ai/guides/auto-embedding.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for embedding function definition, vector field creation, dimensions parameter, data insertion, and vector search.
  • ai/guides/connect.md
    • Changed 'TiDB client' to 'PyTiDB client' in the title and body.
    • Refined introductory sentences for clarity.
    • Standardized TiDB Cloud Starter cluster connection instructions.
    • Clarified TLS note for PyTiDB client.
    • Improved phrasing for self-managed TiDB and connection string construction.
    • Updated 'Fulltext Search' to 'Full-Text search' in related guides.
  • ai/guides/filtering.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for overview, dictionary filters, compare operators, logical operators, and SQL string filters.
  • ai/guides/image-search.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for embedding function definition, Jina AI API key, data insertion, and image search options.
  • ai/guides/join-queries.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for connecting to TiDB using TiDBClient.
  • ai/guides/raw-queries.md
    • Changed 'This document introduces' to 'This guide describes'.
    • Improved phrasing for data operations and query data.
    • Refined descriptions for to_pydantic(), to_rows(), to_list(), and to_pandas() methods.
  • ai/guides/reranking.md
    • Improved phrasing for basic usage and Jina AI reranker.
  • ai/guides/tables.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for TableModel usage and create_table parameters.
    • Improved phrasing for data insertion with TableModel and dict.
    • Refined the description of the save method.
    • Improved phrasing for fetching records and the filtering guide link.
    • Corrected a markdown code block.
  • ai/guides/transactions.md
    • Changed 'Transaction' to 'Transactions' in the title.
    • Improved phrasing for ACID support.
  • ai/guides/vector-search.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for table creation, VectorField parameters, SQL table creation, and vector index description.
    • Improved phrasing for data insertion and auto embedding note.
    • Improved phrasing for vector search method and SQL query for nearest neighbors.
    • Improved phrasing for distance threshold and metadata filtering modes.
    • Improved phrasing for multiple vector fields.
  • ai/integrations/embedding-openai-compatible.md
    • Changed 'OpenAI-Compatible Embedding API' to 'OpenAI-compatible embedding model' in the summary.
    • Changed 'OpenAI-like embedding services' to 'OpenAI-compatible embedding services'.
    • Refined introductory sentences for clarity.
    • Improved phrasing for EmbeddingFunction integration.
    • Improved phrasing for Ollama and vLLM examples.
    • Improved phrasing for vector table creation, data insertion, and search.
  • ai/integrations/tidb-mcp-claude-code.md
    • Refined introductory sentences for clarity.
    • Standardized Python/uv and TiDB Cloud Starter cluster prerequisites.
  • ai/integrations/tidb-mcp-claude-desktop.md
    • Refined introductory sentences for clarity.
    • Standardized Python/uv and TiDB Cloud Starter cluster prerequisites.
    • Improved phrasing for setup steps and troubleshooting.
  • ai/integrations/tidb-mcp-cursor.md
    • Refined introductory sentences for clarity.
    • Standardized Python/uv and TiDB Cloud Starter cluster prerequisites.
    • Improved phrasing for troubleshooting.
  • ai/integrations/tidb-mcp-server.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for MCP and TiDB MCP Server understanding.
    • Standardized Python/uv and TiDB Cloud Starter cluster prerequisites.
    • Refined setup steps for STDIO and SSE modes.
  • ai/integrations/tidb-mcp-vscode.md
    • Refined introductory sentences for clarity.
    • Standardized Python/uv and TiDB Cloud Starter cluster prerequisites.
  • ai/integrations/tidb-mcp-windsurf.md
    • Refined introductory sentences for clarity.
    • Standardized Python/uv and TiDB Cloud Starter cluster prerequisites.
  • ai/integrations/vector-search-auto-embedding-amazon-titan.md
    • Refined introductory sentences for clarity.
    • Removed the 'Python usage example' section.
  • ai/integrations/vector-search-auto-embedding-cohere.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for SQL usage example and BYOK usage example.
    • Clarified the usage of the @search suffix.
  • ai/integrations/vector-search-auto-embedding-gemini.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for usage example, SQL vector search function, custom embedding dimensions, and options.
  • ai/integrations/vector-search-auto-embedding-huggingface.md
    • Changed 'HuggingFace' to 'Hugging Face' in the title, summary, and throughout the document.
    • Refined introductory sentences for clarity.
    • Improved phrasing for model availability and notes.
  • ai/integrations/vector-search-auto-embedding-jina-ai.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for usage example.
    • Corrected 'See Also' to 'See also'.
  • ai/integrations/vector-search-auto-embedding-nvidia-nim.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for nv-embed-v1 usage example.
  • ai/integrations/vector-search-auto-embedding-openai.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for usage example and API key configuration.
    • Clarified the note regarding Azure OpenAI API base.
    • Removed the 'Python usage example' section.
  • ai/integrations/vector-search-auto-embedding-overview.md
    • Refined introductory sentences for clarity.
    • Improved phrasing for workflow steps.
    • Corrected a link for Amazon Titan.
    • Updated 'HuggingFace' to 'Hugging Face'.
    • Corrected a link for NVIDIA NIM.
    • Updated internal links for VEC_COSINE_DISTANCE() and VEC_L2_DISTANCE() to reference the correct path.
  • ai/integrations/vector-search-integrate-with-amazon-bedrock.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
    • Refined introductory sentences for clarity.
    • Improved phrasing for AWS CLI configuration and getting started.
  • ai/integrations/vector-search-integrate-with-django-orm.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
    • Refined introductory sentences for clarity.
    • Improved phrasing for sample app run.
    • Clarified django-tidb description and nearest neighbor search.
  • ai/integrations/vector-search-integrate-with-jinaai-embedding.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
    • Refined introductory sentences for clarity.
    • Improved phrasing for sample app run and semantic search.
  • ai/integrations/vector-search-integrate-with-langchain.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
    • Refined introductory sentences for clarity.
    • Improved phrasing for sample code and retriever usage.
  • ai/integrations/vector-search-integrate-with-llamaindex.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
    • Refined introductory sentences for clarity.
    • Improved phrasing for document deletion check.
  • ai/integrations/vector-search-integrate-with-peewee.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
    • Refined introductory sentences for clarity.
    • Improved phrasing for sample app run and connecting to TiDB cluster.
  • ai/integrations/vector-search-integrate-with-sqlalchemy.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
    • Refined introductory sentences for clarity.
    • Improved phrasing for sample app run and connecting to TiDB cluster.
  • ai/integrations/vector-search-integration-overview.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
    • Updated 'Langchain' to 'LangChain'.
    • Improved phrasing for AI frameworks and embedding models.
  • ai/quickstart-via-sql.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
  • ai/reference/vector-search-functions-and-operators.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
  • ai/reference/vector-search-improve-performance.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
  • ai/reference/vector-search-index.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
  • ai/reference/vector-search-limitations.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
  • ai/vector-search-get-started-using-python.md
    • Corrected a duplicated link for TiDB Cloud Starter cluster.
  • tidb-cloud/releases/tidb-cloud-release-notes.md
    • Corrected internal links for 'Full-Text Search with SQL' and 'Full-Text Search with Python'.
Activity
  • The pull request description primarily consists of a template, indicating no specific human activity beyond the initial submission.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request refines the descriptions and wording across numerous AI documentation files. The changes improve clarity, simplicity, and consistency, adhering well to the repository's style guide. Key improvements include simplifying language, using the second person, adopting sentence case for headings, and standardizing formatting for lists and code elements. Many links were also corrected or updated. Overall, these are excellent enhancements to the documentation. I have one minor suggestion for a potential typo.

You can choose one of the modes to set up the TiDB MCP Server in your MCP client.

### STDIO Mode
### STDIO Mod
Copy link
Contributor

Choose a reason for hiding this comment

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

low

It seems there might be a typo in this heading. Did you mean to write STDIO Mode?

Suggested change
### STDIO Mod
### STDIO Mode

@ti-chi-bot
Copy link

ti-chi-bot bot commented Feb 4, 2026

@qiancai: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name Commit Details Required Rerun command
pull-verify 308243a link true /test pull-verify

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

@ti-chi-bot ti-chi-bot bot added the needs-1-more-lgtm Indicates a PR needs 1 more LGTM. label Feb 4, 2026
@ti-chi-bot
Copy link

ti-chi-bot bot commented Feb 4, 2026

[LGTM Timeline notifier]

Timeline:

  • 2026-02-04 03:59:42.520030283 +0000 UTC m=+239453.621429000: ☑️ agreed by lilin90.

@lilin90 lilin90 added the translation/no-need No need to translate this PR. label Feb 4, 2026
@ti-chi-bot ti-chi-bot bot removed the missing-translation-status This PR does not have translation status info. label Feb 4, 2026
@lilin90 lilin90 added the type/refactor The issue belongs to a refactor work. label Feb 4, 2026
@qiancai qiancai merged commit a394268 into pingcap:feature/preview-top-navigation Feb 4, 2026
4 of 9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-1-more-lgtm Indicates a PR needs 1 more LGTM. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. translation/no-need No need to translate this PR. type/refactor The issue belongs to a refactor work.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants