diff --git a/doc/basics.md b/doc/basics.md
index 02d1100c..ac598614 100644
--- a/doc/basics.md
+++ b/doc/basics.md
@@ -108,7 +108,7 @@ SIMDJSON_PADDING bytes at the end) and calling `parse()`:
 
 ```c++
 dom::parser parser;
-dom::element doc = parser.parse("[1,2,3]"_padded); // parse a string
+dom::element doc = parser.parse("[1,2,3]"_padded); // parse a string, the _padded suffix creates a simdjson::padded_string instance
 ```
 
 The parsed document resulting from the `parser.load` and `parser.parse` calls depends on the `parser` instance. Thus the `parser` instance must remain in scope. Furthermore, you must have at most one parsed document in play per `parser` instance.
diff --git a/doc/basics_doxygen.md b/doc/basics_doxygen.md
index 8253e4cd..1927d1a0 100644
--- a/doc/basics_doxygen.md
+++ b/doc/basics_doxygen.md
@@ -89,7 +89,7 @@ SIMDJSON_PADDING bytes at the end) and calling `parse()`:
 
 ```
 dom::parser parser;
-dom::element doc = parser.parse("[1,2,3]"_padded); // parse a string
+dom::element doc = parser.parse("[1,2,3]"_padded); // parse a string, the _padded suffix creates a simdjson::padded_string instance
 ```
 
 The parsed document resulting from the `parser.load` and `parser.parse` calls depends on the `parser` instance. Thus the `parser` instance must remain in scope. Furthermore, you must have at most one parsed document in play per `parser` instance.