Automated doc testing (#3)

Author: f3ath

.doc2test.ini

@@ -0,0 +1,2 @@
+source = ./index.md
+destination = ./doc-test

.gitignore

@@ -0,0 +1,4 @@
+composer.phar
+/vendor/
+composer.lock
+/doc-test

composer.json

@@ -0,0 +1,9 @@
+{
+    "require-dev": {
+        "json-api-php/json-api": "^1.0",
+        "doc2test/doc2test": "dev-master"
+    },
+    "scripts": {
+        "test": "vendor/bin/doc2test && vendor/bin/phpunit -c doc-test/phpunit.xml --coverage-text"
+    }
+}

index.md

@@ -11,6 +11,7 @@ specification in a set of PHP 7 classes. We adhere to the following concepts:
 ## Example
 
 This JSON response...
+<!-- name=my_json -->
 ```json
 {
     "data": [
@@ -111,10 +112,9 @@ This JSON response...
 }
 ```
 ...can be build with this PHP code
+<!-- assert=output expect=my_json -->
 ```php
 <?php
-require_once __DIR__ . '/vendor/autoload.php';
-
 use JsonApiPhp\JsonApi\Document;
 use JsonApiPhp\JsonApi\Document\Resource\Linkage\MultiLinkage;
 use JsonApiPhp\JsonApi\Document\Resource\Linkage\SingleLinkage;