adding initial README (links TBD)

README.md

@@ -0,0 +1,46 @@
+# Hyperlink
+
+*Cool URLs that don't change.*
+
+Hyperlink provides a pure-Python implementation of immutable
+URLs. Based on RFC 3986 and 3987, the Hyperlink URL makes working with
+both URIs and IRIs easy.
+
+Hyperlink is tested against Python 2.7, 3.4, 3.5, and PyPy.
+
+Full documentation is available on [Read the Docs](#).
+
+## Installation
+
+Hyperlink is a pure-Python package and requires nothing but
+Python. The easiest way to install is with pip:
+
+```
+   pip install hyperlink
+```
+
+Then, hyperlink away!
+
+```python
+
+    from hyperlink import URL
+
+    url = URL.from_text('http://github.com/mahmoud/hyperlink?utm_souce=README')
+    utm_source = url.get('utm_source')
+    better_url = url.replace(scheme='https')
+    user_url = better_url.click('..')
+
+```
+
+See the full API docs [here](#).
+
+## More information
+
+Hyperlink would not have been possible without the help of
+[Glyph Lefkowitz](#) and many other community members, especially
+considering that it started as an extract from the Twisted networking
+library. Thanks to them, Hyperlink's URL has been production-grade for
+well over a decade.
+
+Still, should you encounter any issues, do file an issue, or submit a
+pull request.