Added info and doc link to readme

README.md

@@ -1,12 +1,21 @@
-# dhii - wp-i18n
+# Dhii - WP I18n
 
 [![Build Status](https://travis-ci.org/Dhii/wp-i18n.svg?branch=master)](https://travis-ci.org/dhii/wp-i18n)
 [![Code Climate](https://codeclimate.com/github/Dhii/wp-i18n/badges/gpa.svg)](https://codeclimate.com/github/Dhii/wp-i18n)
 [![Test Coverage](https://codeclimate.com/github/Dhii/wp-i18n/badges/coverage.svg)](https://codeclimate.com/github/Dhii/wp-i18n/coverage)
 [![Latest Stable Version](https://poser.pugx.org/dhii/wp-i18n/version)](https://packagist.org/packages/dhii/wp-i18n)
+[![This package complies with Dhii standards](https://img.shields.io/badge/Dhii-Compliant-green.svg?style=flat-square)][Dhii]
 
-Internationalization for WP
+## Internationalization for WP
+Conventional WordPress means of i18n prevent us from writing good code. What this package solves:
 
-This package complies with [Dhii] standards
+- Use Dependency Injection, and avoid global state.
+- De-couple your code from the global `__()` function, and thus from WP itself.
+- Remove the duplicate hard-coded text domain; instead, centralize it, and de-couple consuming logic from it.
+- Use a standards-compliant mechanism, while continuig to use the same familiar gettext tools, like Poedit.
+- Make your code more testable.
+
+For more information about the how and why, please see the [Wiki documentation][docs].
 
 [Dhii]: https://github.com/Dhii/dhii
+[docs]: https://github.com/Dhii/wp-i18n/wiki