diff --git a/lib/base/json.hpp b/lib/base/json.hpp
index badf4d7ef..868f8f0ac 100644
--- a/lib/base/json.hpp
+++ b/lib/base/json.hpp
@@ -50,9 +50,7 @@ class Value;
  * The supported stream types include any @c std::ostream like objects and our own @c AsyncJsonWriter, which
  * allows writing JSON data to an Asio stream asynchronously. The nlohmann/json library already provides
  * full support for the former stream type, while the latter is fully implemented by our own and satisfies the
- * @c nlohmann::detail::output_adapter_protocol<> interface as well. Therefore, any concrete implementation of
- * @c AsyncJsonWriter may be used to write the produced JSON directly to an Asio either TCP or TLS stream without
- * any additional buffering other than the one used by the Asio buffered_stream<> class internally.
+ * @c nlohmann::detail::output_adapter_protocol<> interface as well.
  *
  * The JSON encoder generates most of the low level JSON tokens, but it still relies on the already existing
  * @c nlohmann::detail::serializer<> class to dump numbers and ASCII validated JSON strings. This means that the
diff --git a/test/base-json.cpp b/test/base-json.cpp
index 8df282c89..4ae17bf09 100644
--- a/test/base-json.cpp
+++ b/test/base-json.cpp
@@ -32,7 +32,7 @@ BOOST_AUTO_TEST_CASE(encode)
 		{ "false", false },
 		// Use double max value to test JSON encoding of large numbers and trigger boost numeric_cast exceptions
 		{ "max_double", std::numeric_limits<double>::max() },
-		// Test the maximum number that can be exact represented by a double is 2^64-2048.
+		// Test the largest uint64_t value that has an exact double representation (2^64-2048).
 		{ "max_int_in_double", std::nextafter(std::pow(2, 64), 0.0) },
 		{ "float", -1.25f },
 		{ "float_without_fraction", 23.0f },