Added changelog, upgrade and contributing documents to repo

Author: norberttech

CHANGELOG.md

@@ -0,0 +1,38 @@
+# 2.0 
+
+* Added support for PHP7 
+* Updated dependencies to support Symfony3 components
+* Added ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\MatchRegexTest`` expander - [email protected]
+* Added ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\IsEmpty`` expander - [email protected]
+* Added PHPMatcher facade in order to improve developers experience
+ 
+
+# 1.1 
+
+* Added pattern expanders mechanism with following expanders: 
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\Contains``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\EndsWith``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\GreaterThan``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\InArray``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\IsDateTime``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\IsEmail``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\IsUrl``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\LowerThan``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\MatchRegex``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\OneOf``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\StartsWith``
+    
+# 1.0
+
+* PHPMatcher initial release with following matchers:
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\ArrayMatcher``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\CallbackMatcher``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\CaptureMatcher``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\ChainMatcher``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\ExpressionMatcher``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\JsonMatcher``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\NullMatcher``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\ScalarMatcher``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\TypeMatcher``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\WildcardMatcher``
+    * ``Coduo\PHPMatcher\Tests\Matcher\Pattern\Expander\XmlMatcher``

CONTRIBUTING.md

@@ -0,0 +1,39 @@
+#A quick guide to contribute to the project:
+
+##Installing the dev environment
+
+1.  Fork the repo
+2.  Clone the repo to local
+3.  Install dependencies: `composer update` (this assumes you have 'composer' aliased to whereever your composer.phar lives)
+4.  Run the tests. We only take pull requests with passing tests, and it's great to know that you have a clean slate:
+    `./bin/phpunit`
+
+##Coding Standards
+
+Try use similar coding standards to what you see in the project to keep things clear to the contributors. If you're unsure, it's always a safe bet to fall-back to the PSR standards.
+
+[PSR-1: Basic Coding Standard](http://www.php-fig.org/psr/psr-1/)
+
+[PSR-2: Coding Style Guide](http://www.php-fig.org/psr/psr-2/)
+
+##Adding new features
+
+Pull requests with new features needs to be created against master branch. 
+
+If new feature require BC Breake please note that in your PR comment, it will added in next major version.
+New features that does not have any BC Breakes are going to be added in next minor version.
+
+##Patches and bugfixes 
+
+1. Check the oldest version that patch/bug fix can be applied.
+2. Create PR against that version 
+
+For example if you are fixing pattern expander that was introduced in version 1.1 make sure that PR with fix 
+is created against version 1.1, not master or 2.0 
+
+##The actual contribution
+
+1.  Make the changes/additions to the code, committing often and making clear what you've done
+2.  Make sure you write tests for your code, located in the folder structure `tests/Coduo/PHPMatcher/...`
+3.  Run your tests (often and while coding): `./bin/phpunit`
+4.  Create Pull Request on github to against proper branch

LICENCE

@@ -1,4 +1,4 @@
-Copyright (c) 2014 Michal Dabrowski, Norbert Orzechowicz
+Copyright (c) 2014-2016 Michal Dabrowski, Norbert Orzechowicz
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation

UPGRADE.md

@@ -0,0 +1,11 @@
+# Upgrade from 1.1 to 2.0 
+
+* All classes are now marked as final in order to close extra extension points 
+* ``Coduo\PHPMatcher\Matcher\CaptureMatcher`` was removed
+* ``Coduo\PHPMatcher\Matcher\TypeMatcher`` was removed 
+* ``Coduo\PHPMatcher\Matcher\PropertyMatcher`` interface was remved
+* Removed ``match`` function
+
+# Upgrade from 1.0 to 1.1
+
+*No known BC Breakes*

composer.json

@@ -1,7 +1,7 @@
 {
     "name": "coduo/php-matcher",
     "type": "library",
-    "keywords": ["json", "matcher", "tests"],
+    "keywords": ["json", "matcher", "tests", "match"],
     "license": "MIT", 
     "authors": [
         {