diff --git a/docs/concepts/architecture.md b/docs/concepts/architecture.md
index 5894524b..4523e92a 100644
--- a/docs/concepts/architecture.md
+++ b/docs/concepts/architecture.md
@@ -13,4 +13,4 @@ In the below diagram you can see the different layers of library and its depende
 
 ![architecture diagram](architecture.png)
 
-Although there are two APIs, the High Level API is the recommended way to interact with the library as it provides a more type safe way to interact with DynamoDB.
+Although there are two APIs, the High Level API is the recommended way to interact with the library as it provides a type safe way to interact with DynamoDB together with a huge amount of boilerplate reduction.
diff --git a/docs/reference/dynamodb-query.md b/docs/reference/dynamodb-query.md
index 3195c66b..09ef3f2c 100644
--- a/docs/reference/dynamodb-query.md
+++ b/docs/reference/dynamodb-query.md
@@ -3,7 +3,9 @@ id: dynamodb-query
 title: "DynamoDBQuery"
 ---
 
-interaction with DynamoDBExecutor
+TODO
+
+interaction with DynamoDBExecutor?
 
 - put
 - get