Merge branch 'master' of https://github.com/JavaMoney/javamoney-shelter.git

Author: keilw

README.md

@@ -1,4 +1,23 @@
-javamoney-shelter
-=================
+Welcome to the JavaMoney Shelter
+================================
+
+JavaMoney-shelter is a sandbox or "sanctuary" for new ideas and modules to be adopted, e.g. via Adopt-a-JSR or similar programs.
+The shelter also acts as incubator module for testing out new features or modules before they may enter the official javamoney library.
+This allows to gain experience and make components error prone and performant and enables a discussion of new features with a broader community.
+
+[Presentation Bitcoin, Payment Instrument or Object of Speculation? from Werner Keil](http://www.slideshare.net/keilw/bitcoin-payment-instrument-or-object-of-speculation-smwhh-2014)
+
+[Gimme Shelter](https://www.youtube.com/watch?v=Jb-JZPmiEOI)
+
+```xml
+<dependency>
+  <groupId>org.javamoney.shelter</groupId>
+  <artifactId>javamoney-${module}<artifactId>
+  <versionId>the current version</version>
+</dependency>
+```
+
+Authors and Contributors
+------------------------
+Everyone is welcome to contribute. Werner Keil (@keilw) composed this project for you.
 
-A shelter for new ideas and modules to be adopted, e.g. via Adopt-a-JSR