diff --git a/README.md b/README.md
index 2ace043..e750750 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,12 @@
 # h2o
-For the "Practical Machine Learning with H2O" book, to be published by O'Reilly (ISBN, etc. coming soon)
+
+This is the code and data repository for the "Practical Machine Learning with H2O" book, [published by O'Reilly](http://shop.oreilly.com/product/0636920053170.do).
+
+**NOTE:** content is kept in the "bk" branch. Please switch to it now.
+
+As well as direct from O'Reilly, it is also available in places like [Amazon US](https://www.amazon.com/Practical-Machine-Learning-H2O-Techniques/dp/149196460X) and [Amazon UK](http://amazon.co.uk/Practical-Machine-Learning-H20-Techniques/dp/149196460X/?tag=wwwdcookorg-21)  ( Print ISBN: 978-1-4919-6460-6;   Ebook ISBN: 978-1-4919-6454-5 )
+
+If you find any errors in the code found here, please file a bug report here. For mistakes or typos in the text of the book, use [the book's errata page](http://www.oreilly.com/catalog/errata.csp?isbn=0636920053170)
+
+If you have written your own code that gets a better result on one of the data sets in the book, and want to share, please submit a pull request by putting your `contrib` folder. Please make all contributions as public domain, or under the MIT or BSD open source license. Remember to include any additional data sets used (or links to them if they are already open and online somewhere stable).
+