diff --git a/src/libraries/turtle/check.hpp b/src/libraries/turtle/check.hpp
index 74db418..4c908c4 100644
--- a/src/libraries/turtle/check.hpp
+++ b/src/libraries/turtle/check.hpp
@@ -29,7 +29,7 @@ namespace detail
         {
             boost::require_boolean_expr(
                 // if an error is generated by the line below it means
-                // an argument passed to 'with' was of the wrong type.
+                // an argument passed to 'with' was of the wrong type
                 functor_accepts( actual_argument_type )
             );
         }
@@ -47,7 +47,7 @@ namespace detail
         {
             boost::require_boolean_expr(
                 // if an error is generated by the line below it means
-                // an argument passed to 'with' was of the wrong type.
+                // an argument passed to 'with' was of the wrong type
                 actual_argument_type == expected_argument_type
             );
         }
diff --git a/src/libraries/turtle/log.hpp b/src/libraries/turtle/log.hpp
index f521f8f..b7c43e2 100644
--- a/src/libraries/turtle/log.hpp
+++ b/src/libraries/turtle/log.hpp
@@ -65,8 +65,9 @@ namespace detail3
         {}
         virtual void serialize( std::ostream& s ) const
         {
-            // if it fails here because ambiguous stuff
-            // -> add operator<< to mock::stream for T
+            // if an error about an ambiguous conversion is generated by the
+            // line below it means the easiest solution is likely to be to add
+            // a serialization operator to a mock::stream for T
             s << *t_;
         }
         const T* t_;
@@ -121,8 +122,9 @@ namespace detail2
     template< typename T >
     void serialize( stream& s, const T& t )
     {
-        // if it fails here because ambiguous stuff
-        // -> add operator<< to mock::stream for T
+        // if an error about an ambiguous conversion is generated by the
+        // line below it means the easiest solution is likely to be to add
+        // a serialization operator to a mock::stream for T
         s << t;
     }
     inline void serialize( stream& s, bool b )