diff --git a/framework/yii/db/Query.php b/framework/yii/db/Query.php
index 870c66d..301b2e1 100644
--- a/framework/yii/db/Query.php
+++ b/framework/yii/db/Query.php
@@ -23,10 +23,13 @@ use yii\base\Component;
  *
  * ~~~
  * $query = new Query;
+ * // compose the query
  * $query->select('id, name')
  *     ->from('tbl_user')
  *     ->limit(10);
  * // build and execute the query
+ * $rows = $query->all();
+ * // alternatively, you can create DB command and execute it
  * $command = $query->createCommand();
  * // $command->sql returns the actual SQL
  * $rows = $command->queryAll();