diff --git a/doc/design/executor.md b/doc/design/executor.md
index 777f451b111492a4d017acd87b17bd989a3bd4fd..ab2d6c3558cb2464317d6c0f656f9cff6e8d0e4a 100644
--- a/doc/design/executor.md
+++ b/doc/design/executor.md
@@ -1,8 +1,26 @@
-# Executor Desgin Doc
+# Executor Design Doc
+
+## Motivation
+
+We use executor to do the runtime evaluation of a `ProgramDesc`.
 
 ## Overview
 
-`Executor` evaluates a `ProgramDesc`. Essentially, it instantializes Variables and Operators, then run all the operators
+An executor takes a `ProgramDesc`, a `block_id` and a `Scope`.  The `ProgramDesc` is a list of blocks and each block contains the protobuf definition of all the parameters and operators. The `block_id` specifies the entrance block. And the `Scope` is the container of all the variable instance, which is persistent throughout different runs.
+
+### What does executor do?
+
+It evaluates all the operators in the `block_id`th block of a `ProgramDesc`.
+
+### What does executor NOT do?
+
+It does not do runtime optimization, meaning intelligently parse the dependency of each op a choose which one to be run and in which order they should be run.
+
+It does not do graph partitioning, meaning dividing the `ProgramDesc` into several small pieces and executing them on different devices.
+
+## Implementation
+
+`Executor` evaluates a `ProgramDesc`. Essentially, it instantiates Variables and Operators, then run all the operators
 
 ```c++
 void Executor::Run(const ProgramDesc& pdesc, Scope* scope, int block_id) {