diff --git a/README.md b/README.md
index c11d78a..785f74d 100644
--- a/README.md
+++ b/README.md
@@ -134,9 +134,18 @@ local yui = require 'lib.yui'
 
 ## Documentation
 
-...Ouch.
+Code is documented with [LDoc](https://github.com/lunarmodules/LDoc).
 
-Documentation is underway, however the source code is (IMHO) sufficiently
+Documentation may be generated running the command:
+
+```sh
+ldoc .
+```
+
+`ldoc` generates a `doc` directory, open `doc/index.html`
+with your favorite browser to read the documentation.
+
+The source code is also (IMHO) sufficiently
 straightforward and disciplined to have a decent overview of the functionality.
 
 Examples are available at: