diff --git a/py/doc/TODO.txt b/py/doc/TODO.txt
index 4acf570b8..b1077eef5 100644
--- a/py/doc/TODO.txt
+++ b/py/doc/TODO.txt
@@ -22,7 +22,8 @@ review all py lib documentation
 streamline exported API 
 -------------------------------------
 
-* (hpk, should be done) move not-to-be-exported Gateway() methods to _ - methods. 
+* (DONE) move not-to-be-exported Gateway() methods to _ - methods. 
+
 * docstrings  for all exported API
 
 * (DONE) remove: test.compat.TestCAse 
diff --git a/py/doc/log.txt b/py/doc/log.txt
index af55001ab..a1cbc3f71 100644
--- a/py/doc/log.txt
+++ b/py/doc/log.txt
@@ -15,8 +15,8 @@ This document is an attempt to briefly state the actual specification of the
 :code:`py.log` module.  It was written by Francois Pinard and also contains
 some ideas for enhancing the py.log facilities. 
 
-
-NOTE that `py.log` is an ALPHA interface, it can change any time. 
+NOTE that `py.log` is subject to refactorings, it may change with
+the next release. 
 
 This document is meant to trigger or facilitate discussions.  It shamelessly
 steals from the `Agile Testing`__ comments, and from other sources as well,
@@ -24,8 +24,6 @@ without really trying to sort them out.
 
 __ http://agiletesting.blogspot.com/2005/06/keyword-based-logging-with-py-library.html
 
-My knowledge of English is fairly rough and approximative, I hope
-readers will kindly and spontaneously offer stylistic corrections.
 
 Logging organisation
 ====================