Add the README.md.

1 files changed, 38 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c3cb618
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+![Hoa](http://static.hoa-project.net/Image/Hoa_small.png)
+
+Hoa is a **modular**, **extensible** and **structured** set of PHP libraries.
+Moreover, Hoa aims at being a bridge between industrial and research worlds.
+
+# Hoa\Registry
+
+This library proposes a static register with facilities.
+
+## Quick usage
+
+As a quick overview, we propose to set an entry and retrieve it from the
+`hoa://` protocol:
+
+    Hoa\Register::set('foo', 'bar');
+    var_dump(
+        Hoa\Registry::get('foo'),
+        resolve('hoa://Library/Registry#foo')
+    );
+
+    /**
+     * Will output:
+     *     string(3) "bar"
+     *     string(3) "bar"
+     */
+
+There is no restriction about the key form or the value type. We can store any
+kinds of type: objects, functions, resources…
+
+## Documentation
+
+Different documentations can be found on the website:
+[http://hoa-project.net/](http://hoa-project.net/).
+
+## License
+
+Hoa is under the New BSD License (BSD-3-Clause). Please, see
+[`LICENSE`](http://hoa-project.net/LICENSE).