add repository meta information

Author: m-bymike

.gitignore

@@ -130,4 +130,5 @@ nb-configuration.xml
 .nb-gradle/
 
 ### Composer template
+composer.lock
 /vendor/

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Sclable Business Solutions GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -1,4 +1,41 @@
 Sclable Array Functions
 =======================
 
-An introduction.
+An array wrapper to normalize php array functions, give them
+an ObjectOriented and functional programming approach.
+
+Installation
+------------
+
+With [Composer](https://getcomposer.org):
+```
+composer require sclable/array-functions
+```
+
+Usage
+-----
+
+```php
+echo ArrayWrap::range(0, 10)
+    ->filter(function ($nr) { return $nr < 3; })
+    ->map(function ($nr) { return "Number: $nr\n"; })
+    ->reverse();
+
+// echoes
+// Number: 2
+// Number: 1
+// Number: 0
+```
+
+Contribute
+----------
+
+Clone/fork the repository as you like. To get started, run `composer install`.
+
+- PHPUnit Tests preferred
+- PSR-2 Coding style must apply
+
+License
+-------
+
+see [LICENSE](LICENSE).