diff --git a/letsencrypt/acme/__init__.py b/letsencrypt/acme/__init__.py
index 95744bbd5..c38cea414 100644
--- a/letsencrypt/acme/__init__.py
+++ b/letsencrypt/acme/__init__.py
@@ -1,22 +1,12 @@
 """ACME protocol implementation.
 
-.. warning:: This module is an implementation of the draft `ACME
-  protocol version 00`_, and not the latest (as of time of writing),
-  "RESTified" `ACME protocol version 01`_. It should work with the
-  server from the `Node.js implementation`_,  but will not work with
-  Boulder_.
-
+This module is an implementation of the `ACME protocol`_. Latest
+supported version: `v02`_.
 
 .. _`ACME protocol`: https://github.com/letsencrypt/acme-spec
 
-.. _`ACME protocol version 00`:
-  https://github.com/letsencrypt/acme-spec/blob/v00/draft-barnes-acme.md
+.. _`v02`:
+  https://github.com/letsencrypt/acme-spec/commit/d328fea2d507deb9822793c512830d827a4150c4
 
-.. _`ACME protocol version 01`:
-  https://github.com/letsencrypt/acme-spec/blob/v01/draft-barnes-acme.md
-
-.. _Boulder: https://github.com/letsencrypt/boulder
-
-.. _`Node.js implementation`: https://github.com/letsencrypt/node-acme
 
 """
diff --git a/letsencrypt/acme/messages.py b/letsencrypt/acme/messages.py
index 412b9fb84..41b7389a7 100644
--- a/letsencrypt/acme/messages.py
+++ b/letsencrypt/acme/messages.py
@@ -1,4 +1,25 @@
-"""ACME protocol messages."""
+"""ACME protocol v00 messages.
+
+.. warning:: This module is an implementation of the draft `ACME
+  protocol version 00`_, and not the "RESTified" `ACME protocol version
+  01`_ or later. It should work with `older Node.js implementation`_,
+  but will definitely not work with Boulder_. It is kept for reference
+  purposes only.
+
+
+.. _`ACME protocol version 00`:
+  https://github.com/letsencrypt/acme-spec/blob/v00/draft-barnes-acme.md
+
+.. _`ACME protocol version 01`:
+  https://github.com/letsencrypt/acme-spec/blob/v01/draft-barnes-acme.md
+
+.. _Boulder: https://github.com/letsencrypt/boulder
+
+.. _`older Node.js implementation`:
+  https://github.com/letsencrypt/node-acme/commit/f42aa5b7fad4cd2fc289653c4ab14f18052367b3
+
+
+"""
 import jsonschema
 
 from letsencrypt.acme import challenges
diff --git a/letsencrypt/acme/messages2.py b/letsencrypt/acme/messages2.py
index 463198d5e..93f77a3e9 100644
--- a/letsencrypt/acme/messages2.py
+++ b/letsencrypt/acme/messages2.py
@@ -1,4 +1,4 @@
-"""ACME protocol v02 messages."""
+"""ACME protocol messages."""
 from letsencrypt.acme import challenges
 from letsencrypt.acme import fields
 from letsencrypt.acme import jose