pingcap/tidb-dev-guide

A comprehensive development guide to help you be more and more familiar with the TiDB community and become an expert finally.

126

226 commits

updated May 1, 2026

See the code

README

TiDB Development Guide

This repository contains the source of TiDB Development Guide.

  • The target audience of this guide is TiDB contributors, both new and experienced.
  • The objective of this guide is to help contributors become an expert of TiDB, who is familiar with its design and implementation and thus is able to use it fluently in the real world as well as develop TiDB itself deeply.

Requirements

Building the book requires mdBook. To get it:

$ cargo install mdbook

Building

To build the book, type:

$ mdbook build

The output will be in the book subdirectory. To check it out, open it in your web browser.

Firefox:

$ firefox book/html/index.html                       # Linux
$ open -a "Firefox" book/html/index.html             # OS X
$ Start-Process "firefox.exe" .\book\html\index.html # Windows (PowerShell)
$ start firefox.exe .\book\html\index.html           # Windows (Cmd)

Chrome:

$ google-chrome book/html/index.html                 # Linux
$ open -a "Google Chrome" book/html/index.html       # OS X
$ Start-Process "chrome.exe" .\book\html\index.html  # Windows (PowerShell)
$ start chrome.exe .\book\html\index.html            # Windows (Cmd)

Contribute to this guide

See CONTRIBUTING for details.

development
distributed-database
guide
tidb

Contributors

(top 30 of 50)

zhangyangyu

53 commits

tisonkun

25 commits

zz-jason

19 commits

pingcap/tidb-dev-guide

A comprehensive development guide to help you be more and more familiar with the TiDB community and become an expert finally.

126

226 commits

updated May 1, 2026

See the code

README

TiDB Development Guide

This repository contains the source of TiDB Development Guide.

  • The target audience of this guide is TiDB contributors, both new and experienced.
  • The objective of this guide is to help contributors become an expert of TiDB, who is familiar with its design and implementation and thus is able to use it fluently in the real world as well as develop TiDB itself deeply.

Requirements

Building the book requires mdBook. To get it:

$ cargo install mdbook

Building

To build the book, type:

$ mdbook build

The output will be in the book subdirectory. To check it out, open it in your web browser.

Firefox:

$ firefox book/html/index.html                       # Linux
$ open -a "Firefox" book/html/index.html             # OS X
$ Start-Process "firefox.exe" .\book\html\index.html # Windows (PowerShell)
$ start firefox.exe .\book\html\index.html           # Windows (Cmd)

Chrome:

$ google-chrome book/html/index.html                 # Linux
$ open -a "Google Chrome" book/html/index.html       # OS X
$ Start-Process "chrome.exe" .\book\html\index.html  # Windows (PowerShell)
$ start chrome.exe .\book\html\index.html            # Windows (Cmd)

Contribute to this guide

See CONTRIBUTING for details.

development
distributed-database
guide
tidb

Contributors

(top 30 of 50)

zhangyangyu

53 commits

tisonkun

25 commits

zz-jason

19 commits