pingcap · lilin90 · Jul 25, 2018 · Jul 23, 2018 · Jul 25, 2018 · Jul 25, 2018
diff --git a/op-guide/ansible-deployment-rolling-update.md b/op-guide/ansible-deployment-rolling-update.md
@@ -1,5 +1,6 @@
 ---
 title: Upgrade TiDB Using TiDB-Ansible
+summary: Use TiDB-Ansible to perform a rolling update for a TiDB cluster.
 category: operations
 ---
 

diff --git a/op-guide/ansible-deployment-scale.md b/op-guide/ansible-deployment-scale.md
@@ -1,5 +1,6 @@
 ---
 title: Scale the TiDB Cluster Using TiDB-Ansible
+summary: Use TiDB-Ansible to increase/decrease the capacity of a TiDB/TiKV/PD node.
 category: operations
 ---
 

diff --git a/op-guide/ansible-deployment.md b/op-guide/ansible-deployment.md
@@ -1,5 +1,6 @@
 ---
 title: Deploy TiDB Using Ansible
+summary: Use Ansible to deploy a TiDB cluster.
 category: operations
 ---
 

diff --git a/op-guide/ansible-operation.md b/op-guide/ansible-operation.md
@@ -1,5 +1,6 @@
 ---
 title: TiDB-Ansible Common Operations
+summary: Learn some common operations when using TiDB-Ansible to administer a TiDB cluster.
 category: operations
 ---
 

diff --git a/op-guide/backup-restore.md b/op-guide/backup-restore.md
@@ -1,13 +1,14 @@
 ---
 title: Backup and Restore
+summary: Learn how to backup and restore data of TiDB.
 category: operations
 ---
 
 # Backup and Restore
 
 ## About
 
-This document describes how to backup and restore the data of TiDB. Currently, this document only covers full backup and restoration.
+This document describes how to backup and restore data of TiDB. Currently, this document only covers full backup and restoration.
 
 Here we assume that the TiDB service information is as follows:
 

diff --git a/op-guide/configuration.md b/op-guide/configuration.md
@@ -1,5 +1,6 @@
 ---
 title: Configuration Flags
+summary: Learn some configuration flags of TiDB, TiKV and PD.
 category: operations
 ---
 

diff --git a/op-guide/dashboard-overview-info.md b/op-guide/dashboard-overview-info.md
@@ -1,5 +1,6 @@
 ---
 title: Key Metrics
+summary: Learn some key metrics displayed on the Grafana Overview dashboard.
 category: operations
 ---
 

diff --git a/op-guide/docker-compose.md b/op-guide/docker-compose.md
@@ -1,6 +1,6 @@
 ---
 title: TiDB Docker Compose Deployment
-summary: Deploy a TiDB testing cluster with a single command using Docker Compose.
+summary: Use Docker Compose to quickly deploy a TiDB testing cluster.
 category: operations
 ---
 

diff --git a/op-guide/docker-deployment.md b/op-guide/docker-deployment.md
@@ -1,5 +1,6 @@
 ---
 title: Deploy TiDB Using Docker
+summary: Use Docker to manually deploy a multi-node TiDB cluster on multiple machines.
 category: operations
 ---
 

diff --git a/op-guide/gc.md b/op-guide/gc.md
@@ -1,5 +1,6 @@
 ---
 title: TiDB Garbage Collection (GC)
+summary: Use TiDB Garbage Collection (GC) to clear obsolete data.
 category: advanced
 ---
 

diff --git a/op-guide/generate-self-signed-certificates.md b/op-guide/generate-self-signed-certificates.md
@@ -1,5 +1,6 @@
 ---
 title: Generate Self-signed Certificates
+summary: Use `cfssl` to generate self-signed certificates.
 category: deployment
 ---
 

diff --git a/op-guide/history-read.md b/op-guide/history-read.md
@@ -1,5 +1,6 @@
 ---
 title: Reading Data from History Versions
+summary: Learn about how TiDB reads data from history versions.
 category: advanced
 ---
 

diff --git a/op-guide/horizontal-scale.md b/op-guide/horizontal-scale.md
@@ -1,5 +1,6 @@
 ---
 title: Scale a TiDB cluster
+summary: Learn how to add or delete PD, TiKV and TiDB nodes.
 category: operations
 ---
 

diff --git a/op-guide/location-awareness.md b/op-guide/location-awareness.md
@@ -1,5 +1,6 @@
 ---
 title: Cross-Region Deployment
+summary: Learn the cross-region deployment that maximizes the capacity for disaster recovery.
 category: operations
 ---
 

diff --git a/op-guide/migration-overview.md b/op-guide/migration-overview.md
@@ -1,5 +1,6 @@
 ---
 title: Migration Overview
+summary: Learn how to migrate data from MySQL to TiDB.
 category: operations
 ---
 

diff --git a/op-guide/migration.md b/op-guide/migration.md
@@ -1,5 +1,6 @@
 ---
 title: Migrate Data from MySQL to TiDB
+summary: Use `mydumper`, `loader` and `syncer` tools to migrate data from MySQL to TiDB.
 category: operations
 ---
 

diff --git a/op-guide/monitor-overview.md b/op-guide/monitor-overview.md
@@ -1,5 +1,6 @@
 ---
 title: Overview of the TiDB Monitoring Framework
+summary: Use Prometheus and Grafana to construct the TiDB monitoring framework.
 category: operations
 ---
 

diff --git a/op-guide/monitor.md b/op-guide/monitor.md
@@ -1,5 +1,6 @@
 ---
 title: Monitor a TiDB Cluster
+summary: Learn how to monitor the state of a TiDB cluster.
 category: operations
 ---
 

diff --git a/op-guide/offline-ansible-deployment.md b/op-guide/offline-ansible-deployment.md
@@ -1,5 +1,6 @@
 ---
 title: Deploy TiDB Offline Using Ansible
+summary: Use Ansible to deploy a TiDB cluster offline.
 category: operations
 ---
 

diff --git a/op-guide/recommendation.md b/op-guide/recommendation.md
@@ -1,5 +1,6 @@
 ---
 title: Software and Hardware Requirements
+summary: Learn the software and hardware requirements for deploying and running TiDB.
 category: operations
 ---
 

diff --git a/op-guide/security.md b/op-guide/security.md
@@ -1,5 +1,6 @@
 ---
 title: Enable TLS Authentication
+summary: Learn how to enable TLS authentication in a TiDB cluster.
 category: deployment
 ---
 

diff --git a/op-guide/tidb-config-file.md b/op-guide/tidb-config-file.md
@@ -1,5 +1,6 @@
 ---
 title: TiDB Configuration File Description
+summary: Learn the TiDB configuration file options that are not involved in command line options.
 category: deployment
 ---
 

diff --git a/op-guide/tidb-v2-upgrade-guide.md b/op-guide/tidb-v2-upgrade-guide.md
@@ -1,11 +1,12 @@
 ---
 title: TiDB 2.0 Upgrade Guide
+summary: Learn how to upgrade from TiDB 1.0/TiDB 2.0 RC version to TiDB 2.0 GA version.
 category: deployment
 ---
 
 # TiDB 2.0 Upgrade Guide
 
-This document describes how to upgrade from TiDB 1.0 or TiDB 2.0 RC versions to TiDB 2.0 GA.
+This document describes how to upgrade from TiDB 1.0 or TiDB 2.0 RC version to TiDB 2.0 GA version.
 
 ## Install Ansible and dependencies in the Control Machine
 

diff --git a/op-guide/tune-tikv.md b/op-guide/tune-tikv.md
@@ -1,5 +1,6 @@
 ---
 title: Tune TiKV Performance
+summary: Learn how to tune the TiKV parameters for optimal performance.
 category: tuning
 ---
 

diff --git a/tools/loader.md b/tools/loader.md
@@ -1,5 +1,6 @@
 ---
 title: Loader Instructions
+summary: Use Loader to load data to TiDB.
 category: advanced
 ---
 

diff --git a/tools/pd-control.md b/tools/pd-control.md
@@ -1,5 +1,6 @@
 ---
 title: PD Control User Guide
+summary: Use PD Control to obtain the state information of a cluster and tune a cluster.
 category: tools
 ---
 

diff --git a/tools/syncer.md b/tools/syncer.md
@@ -1,5 +1,6 @@
 ---
 title: Syncer User Guide
+summary: Use Syncer to import data incrementally to TiDB.
 category: advanced
 ---
 

diff --git a/tools/tidb-binlog-kafka.md b/tools/tidb-binlog-kafka.md
@@ -1,5 +1,6 @@
 ---
 title: TiDB-Binlog user guide
+summary: Learn how to deploy the Kafka version of TiDB-Binlog.
 category: tool
 ---
 

diff --git a/tools/tidb-binlog.md b/tools/tidb-binlog.md
@@ -1,5 +1,6 @@
 ---
 title: TiDB-Binlog user guide
+summary: Learn how to install, deploy and monitor TiDB-Binlog.
 category: tool
 ---
 

diff --git a/tools/tidb-controller.md b/tools/tidb-controller.md
@@ -1,5 +1,6 @@
 ---
 title: TiDB Controller User Guide
+summary: Use TiDB Controller to obtain TiDB status information for debugging.
 category: tools
 ---
 

diff --git a/tools/tikv-control.md b/tools/tikv-control.md
@@ -1,5 +1,6 @@
 ---
 title: TiKV Control User Guide
+summary: Use TiKV Control to manage a TiKV cluster.
 category: tools
 ---