diff --git a/hadoop-hdds/docs/content/tools/TestTools.md b/hadoop-hdds/docs/content/tools/TestTools.md
index bde400d84aef..e6ffb364a21d 100644
--- a/hadoop-hdds/docs/content/tools/TestTools.md
+++ b/hadoop-hdds/docs/content/tools/TestTools.md
@@ -27,7 +27,7 @@ Note: we have more tests (like TCP-DS, TCP-H tests via Spark or Hive) which are
 
 ## Unit test
 
-As every almost every java project we have the good old unit tests inside each of our projects.
+As with every Java project, we have the good old unit tests within each of our projects.
 
 ## Integration test (JUnit)
 
@@ -56,11 +56,11 @@ cd compose/ozone
 
 [Blockade](https://github.com/worstcase/blockade) is a tool to test network failures and partitions (it's inspired by the legendary [Jepsen tests](https://jepsen.io/analyses)).
 
-Blockade tests are implemented with the help of tests and can be started from the `./blockade` directory of the distribution.
+The Blockade test suite is shipped as Python tests under `tests/blockade`. After you build or unpack the distribution, run the commands below from that directory:
 
 ```
-cd blockade
-pip install pytest==2.8.7,blockade
+cd tests/blockade
+pip install pytest==2.8.7 blockade
 python -m pytest -s .
 ```
 
@@ -82,7 +82,7 @@ The number of volumes/buckets/keys can be configured. The replication type and f
 
 For more information use:
 
-bin/ozone freon --help
+ozone freon --help
 
 For example:
 
diff --git a/hadoop-hdds/docs/content/tools/TestTools.zh.md b/hadoop-hdds/docs/content/tools/TestTools.zh.md
index b6b647c90c7b..05f2c7f07f4f 100644
--- a/hadoop-hdds/docs/content/tools/TestTools.zh.md
+++ b/hadoop-hdds/docs/content/tools/TestTools.zh.md
@@ -56,11 +56,11 @@ cd compose/ozone
 
 [Blockade](https://github.com/worstcase/blockade) 是一个测试网络故障和分片的工具（灵感来自于大名鼎鼎的[Jepsen 测试](https://jepsen.io/analyses)）。
 
-Blockade 测试在其它测试的基础上实现，可以在分发包中的 `./blockade` 目录下进行测试。
+Blockade 测试以 Python 脚本形式包含在 `tests/blockade` 目录中。构建或解压发行包后，进入该目录并运行下面的命令：
 
 ```
-cd blockade
-pip install pytest==2.8.7,blockade
+cd tests/blockade
+pip install pytest==2.8.7 blockade
 python -m pytest -s .
 ```
 
@@ -83,7 +83,7 @@ volume/bucket/key的数量是可以配置的。副本type和factor(例如: 3个
 
 更多信息，可使用如下命令查看:
 
-bin/ozone freon --help
+ozone freon --help
 
 例如：