diff --git a/.gitattributes b/.gitattributes
index 78b338aa..88e96eb7 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -7,3 +7,4 @@
 /.travis.yml export-ignore
 /phpunit.xml export-ignore
 /README.md export-ignore
+/body-params.png export-ignore
diff --git a/.gitignore b/.gitignore
index 8532760a..aa07bc91 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,8 +1,17 @@
 .DS_Store
 composer.lock
+*.composer.lock
 .php_cs.cache
 /vendor/
-/public
+public/
+resources/docs/
+resources/views/apidoc/
+tests/public/
 .idea/
 coverage.xml
 results.xml
+docs/_build
+docs/make.bat
+tests/public/docs/
+tests/resources/**
+.phpunit.result.cache
diff --git a/.styleci.yml b/.styleci.yml
index 75bf3532..5d4095a3 100644
--- a/.styleci.yml
+++ b/.styleci.yml
@@ -1,6 +1,2 @@
-preset: laravel
+preset: psr12
 
-enabled:
-  - phpdoc_order
-  - phpdoc_separation
-  - unalign_double_arrow
diff --git a/.travis.yml b/.travis.yml
index 36f2c9ed..23cd9442 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,19 +1,40 @@
+dist: bionic
 language: php
 
-php:
-  - 5.6
-  - 7.0
-  - 7.1
+env:
+  global:
+    - SETUP=stable
 
-before_script:
-  - travis_retry composer self-update
-  - travis_retry composer install --prefer-dist --no-interaction
+matrix:
+  fast_finish: true
+  include:
+    - php: 7.4
+      env: COMPOSER=dingo.composer.json
+      name: "With Dingo router"
+    - php: 7.4
+      env: SETUP=lint
+      name: "Lint code"
+    - php: 7.2
+    - php: 7.2
+      env: SETUP=lowest
+    - php: 7.3
+    - php: 7.3
+      env: SETUP=lowest
+    - php: 7.4
+    - php: 7.4
+      env: SETUP=lowest
 
-script:
-  - composer test-ci
+cache:
+  directories:
+    - $HOME/.composer/cache
 
 before_install:
-  - pip install --user codecov
+  - travis_retry composer self-update
 
-after_success:
-  - codecov
+install:
+  - if [[ $SETUP = 'stable' ]]; then travis_retry composer update --prefer-dist --no-interaction --prefer-stable --no-suggest; fi
+  - if [[ $SETUP = 'lowest' ]]; then travis_retry composer update --prefer-dist --no-interaction --prefer-lowest --prefer-stable --no-suggest; fi
+  - if [[ $SETUP = 'lint' ]]; then travis_retry composer update --prefer-dist --no-interaction --prefer-stable --no-suggest; travis_retry composer lint; fi
+
+script:
+  - if [[ $SETUP = 'lint' ]]; then exit 0; fi; composer test-ci;
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a94d4395..aeeb3851 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,50 +13,334 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+## 4.8.0 - Saturday, 2 May 2020 ([compare to previous](https://github.com/mpociot/laravel-apidoc-generator/compare/4.7.0...4.8.0))
+### Added
+- Support @hideFromAPIDocumentation on controllers. (https://github.com/mpociot/laravel-apidoc-generator/pull/745)
+- Allow strategies to return null. (https://github.com/mpociot/laravel-apidoc-generator/pull/739)
+
+## 4.7.0 - Sunday, 12 April 2020 ([compare to previous](https://github.com/mpociot/laravel-apidoc-generator/compare/4.6.0...4.7.0))
+### Added
+- Support for Laravel Vapor. (https://github.com/mpociot/laravel-apidoc-generator/pull/729)
+- Allow customization of static output path. (https://github.com/mpociot/laravel-apidoc-generator/pull/730)
+
+## 4.6.0 - Wednesday, 8 April 2020 ([compare to previous](https://github.com/mpociot/laravel-apidoc-generator/compare/4.5.1...4.6.0))
+### Added
+- Allow `@authenticated` to be set at controller level. (https://github.com/mpociot/laravel-apidoc-generator/pull/726)
+
+## 4.5.1 - Saturday, 4 April 2020 ([compare to previous](https://github.com/mpociot/laravel-apidoc-generator/compare/4.5.0...4.5.1))
+### Fixed
+- Fix version constraint...again. (https://github.com/mpociot/laravel-apidoc-generator/pull/725)
+
+## 4.5.0 - Tuesday, 31 March 2020 ([compare to previous](https://github.com/mpociot/laravel-apidoc-generator/compare/4.4.3...4.5.0))
+### Fixed
+- Fix version constraints preventing installation on some Laravel 7 installations.
+
+## 4.4.3 - Thursday, 26 March 2020 ([compare to previous](https://github.com/mpociot/laravel-apidoc-generator/compare/4.4.2...4.4.3))
+### Fixed
+- Fixed link to Postman connection in docs when Laravel autoload is used (https://github.com/mpociot/laravel-apidoc-generator/pull/714)
+
+## 4.4.2 - Sunday, 21 March 2020 ([compare to previous](https://github.com/mpociot/laravel-apidoc-generator/compare/4.4.1...4.4.2))
+### Fixed
+- Fixed double json encode when fetching collection in Laravel type docs (https://github.com/mpociot/laravel-apidoc-generator/pull/713)
+
+
+## 4.4.1 - Wednesday, 11 March 2020 ([compare to previous](https://github.com/mpociot/laravel-apidoc-generator/compare/4.4.0...4.4.1))
+### Added
+- Support for body params as array (https://github.com/mpociot/laravel-apidoc-generator/pull/710)
+
+## 4.4.0 - Saturday, 7 March 2020 ([compare to previous](https://github.com/mpociot/laravel-apidoc-generator/compare/4.3.1...4.4.0))
+### Fixed
+- Array query params can now be used and render properly (https://github.com/mpociot/laravel-apidoc-generator/pull/700)
+
+## 4.3.1 - Friday, 6 March 2020 ([compare to previous](https://github.com/mpociot/laravel-apidoc-generator/compare/4.3.0...4.3.1))
+### Changed
+- Updated Documentarian dependency for Laravel v7 (https://github.com/mpociot/laravel-apidoc-generator/pull/699)
+
+## 4.3.0 - Saturday, 22 February 2020 ([compare to previous](https://github.com/mpociot/laravel-apidoc-generator/compare/4.2.4...4.3.0))
+### Changed
+- Updated nunomaduro/collision to include v4 (https://github.com/mpociot/laravel-apidoc-generator/pull/699)
+
+### Fixed
+- Use correct protocol for Postman collcetion URL (https://github.com/mpociot/laravel-apidoc-generator/pull/697)
+
+## [4.2.4] - Saturday, 15 February 2020
+### Fixed
+- Shim URL::formatRoot() on Lumen (https://github.com/mpociot/laravel-apidoc-generator/pull/688)
+
+## [4.2.3] - Tuesday, 4 February 2020
+### Changed
+- Made "Skipping route" message more descriptive (https://github.com/mpociot/laravel-apidoc-generator/commit/6f61469a9fa8be30e7812cf622a7832163a08bb8)
+
+## [4.2.2] - Tuesday, 21 January 2020
+### Fixed
+- Set a default value for the routematcher when fetching from config (https://github.com/mpociot/laravel-apidoc-generator/pull/677)
+
+## [4.2.1] - Monday, 20 January 2020
+### Fixed
+- Fixed autogenerated docs endpoint address for Postman collection (https://github.com/mpociot/laravel-apidoc-generator/pull/673)
+
+## [4.2.0] - Sunday, 19 January 2020
+### Added
+- New Postman collection generation features (https://github.com/mpociot/laravel-apidoc-generator/pull/666):
+  - Properly handle url parameters using the `:param` syntax (opposed to the Laravel-esque `{param}` syntax)
+  - Allow configuring the auth section of Postman collection config
+  - Add some documentation that was available but not exported in the Postman collection (for URL params and query params)
+
+### Changed
+- The package can now create a documentation endpoint automatically for `laravel`-type routes. This also allows users to install the package on dev-only enviornments but have their routes available in others, without writing custom routing code. (https://github.com/mpociot/laravel-apidoc-generator/pull/659)
+
+### Fixed
+- Error when installing due to DI not working properly on constructor (https://github.com/mpociot/laravel-apidoc-generator/pull/672)
+
+## [4.1.0] - Monday, 6 January 2019
+### Added
+- RouteMatcher to use can now be specified by user (https://github.com/mpociot/laravel-apidoc-generator/pull/657)
+
+### Fixed
+- Also copy custom logo for non-static docs (https://github.com/mpociot/laravel-apidoc-generator/commit/720f9c9e9b2443bcfb474b959febaf6cf5c3f004)
+
+## [4.0.2] - Monday, 25 November 2019
+### Fixed
+- Fixed missing body parameters in response calls (https://github.com/mpociot/laravel-apidoc-generator/commit/5d9371c14391485630941c718d7f168afd540126)
+- Add slashes to header values in bash templates to escape special chars (https://github.com/mpociot/laravel-apidoc-generator/commit/e693d746b1c1daf342c28e53daa8f7b34ce9da2b)
+- Fixed iteration over null bug - set responses to empty array (https://github.com/mpociot/laravel-apidoc-generator/commit/a24b1e14b17ade8fb4aa1534448904e1075b004c)
+
+## [4.0.1] - Monday, 16 November 2019
+### Fixed
+- Update rebuild command to work with new docs locations (https://github.com/mpociot/laravel-apidoc-generator/pull/646)
+
+## [4.0.0] - Thursday, 7 November 2019
+### Added
+- Added `headers` stage (https://github.com/mpociot/laravel-apidoc-generator/pull/624)
+- Support for non-static docs, changed source files locations (https://github.com/mpociot/laravel-apidoc-generator/pull/608)
+- Support for Eloquent API resources (https://github.com/mpociot/laravel-apidoc-generator/pull/601)
+- `bindings` replaced by `@urlParam` annotation (https://github.com/mpociot/laravel-apidoc-generator/pull/599)
+- Better support for arrays and objects in bodyParams (https://github.com/mpociot/laravel-apidoc-generator/pull/597)
+
+### Modified
+- Postman collection now have the body as `raw` instead of `formdata`. (https://github.com/mpociot/laravel-apidoc-generator/pull/627)
+- Nonexistent `@responseFile` annotations now show a warning and skip the route (https://github.com/mpociot/laravel-apidoc-generator/pull/620)
+- Use symfony/var-exporter to export PHP arrays, ensuring short array syntax (https://github.com/mpociot/laravel-apidoc-generator/pull/615)
+- Use single quotes in PHP example template (https://github.com/mpociot/laravel-apidoc-generator/pull/612)
+- Transformer annotations are now given priority over all other response strategies (https://github.com/mpociot/laravel-apidoc-generator/pull/620)
+- Made ResponseCalls strategy only execute if no successful responses exist. (https://github.com/mpociot/laravel-apidoc-generator/pull/605)
+- Hide null responses in examples. (https://github.com/mpociot/laravel-apidoc-generator/pull/605)
+- Made `responses` stage additive (https://github.com/mpociot/laravel-apidoc-generator/pull/605)
+- Renamed `query` and `body` in `response_calls` config to `queryParams` and `bodyParams` (https://github.com/mpociot/laravel-apidoc-generator/pull/603)
+
+### Removed
+- Removed `apply.response_calls.headers` in favour of `apply.headers` (https://github.com/mpociot/laravel-apidoc-generator/pull/603)
+- Removed bindings in response_calls (https://github.com/mpociot/laravel-apidoc-generator/pull/599)
+
+## [3.17.1] - Thursday, 12 September 2019
+### Fixed
+- ResponseCalls: Call Lumen application correctly since it does not use HttpKernel (https://github.com/mpociot/laravel-apidoc-generator/pull/585)
+- Update usage of `clean*Parameters` in python template (https://github.com/mpociot/laravel-apidoc-generator/commit/02fb719d0d6c25e6ce72f30dc8b9604449061156)
+- Bugfix: *really* exclude parameters from examples, not just send empty strings (https://github.com/mpociot/laravel-apidoc-generator/commit/762e2e1003d389d6e785d31144eca89c40515926, https://github.com/mpociot/laravel-apidoc-generator/commit/e54b474578b53f97f4737664a63131b315aaf82d)
+
+## [3.17.0] - Saturday, 7 September 2019
+### Added
+- Switched to a plugin architecture that allows support for external strategies (https://github.com/mpociot/laravel-apidoc-generator/pull/570)
+
+### Changed
+- Exclude Laravel Telescope routes when present (https://github.com/mpociot/laravel-apidoc-generator/pull/579)
+- Set status code for transformer response from tag if present (https://github.com/mpociot/laravel-apidoc-generator/pull/581)
+- Set status code for response call from actual response (https://github.com/mpociot/laravel-apidoc-generator/pull/581)
+
+## [3.16.3] - Thursday, 5 September 2019
+### Fixed
+- Removed references to removed helper functions in 6.0 (https://github.com/mpociot/laravel-apidoc-generator/pull/576)
+
+## [3.16.2] - Wednesday, 4 September 2019
+### Fixed
+- Support for Laravel 6 (https://github.com/mpociot/laravel-apidoc-generator/commit/f7dd8d19b75755763e8e20ab4025075eba5cd51a)
+
+## [3.16.1] - Wednesday, 4 September 2019
+### Added
+- Use HTTPS in Postman collection if base_url is HTTPS (https://github.com/mpociot/laravel-apidoc-generator/pull/575)
+
+## [3.16.0] - Wednesday, 4 September 2019
+### Added
+- Support for Laravel 6 (https://github.com/mpociot/laravel-apidoc-generator/pull/572)
 
-## [2.1.5] - 123h September, 2018
+## [3.15.0] - Saturday, 31 August 2019
+### Added
+- Ability to exclude a query or body parameter from being included in the example requests (https://github.com/mpociot/laravel-apidoc-generator/pull/552)
+
+## [3.14.0] - Saturday, 31 August 2019
 ### Fixed
-- Parse JSON responses from `@transformer` tag for DIngo router (https://github.com/mpociot/laravel-apidoc-generator/pull/323)
+- Backwards compatibility for the changes to `@group` introduced in 3.12.0 (https://github.com/mpociot/laravel-apidoc-generator/commit/5647eda35ebb7f8aed35b31790c5f220b736e985)
+
+## [3.13.0] (deleted)
 
-## [2.1.4] - 12th September, 2018
+## [3.12.0] - Sunday, 25 August 2019
 ### Fixed
-- Parse JSON responses from  `@response` and `@transformer` tags correctly (https://github.com/mpociot/laravel-apidoc-generator/pull/321)
+- Specifying an `@group` for a method no longer requires you to add the description. (https://github.com/mpociot/laravel-apidoc-generator/pull/556)
+- Pass the verbosity level down to the Collision library. (https://github.com/mpociot/laravel-apidoc-generator/pull/556)
+
+## [3.11.0] - Friday, 9 August 2019
+### Added
+- Support for query parameters in the bash template (https://github.com/mpociot/laravel-apidoc-generator/pull/545)
+- Include query parameters and headers in the generated Postman collection (https://github.com/mpociot/laravel-apidoc-generator/pull/537)
+- Include Python out of the box as example language (https://github.com/mpociot/laravel-apidoc-generator/pull/524)
+
+### Changed
+- Moved nunomaduro/collision to "suggested" so it doesn't break PHP 7.0 (https://github.com/mpociot/laravel-apidoc-generator/commit/2f3a2144e1a4f1eb0229aea8b4d11707cb4aabbf)
 
-## [2.1.3] - 11th September, 2018
 ### Fixed
-- Parse `@response` tags regardless of HTTP method (https://github.com/mpociot/laravel-apidoc-generator/pull/318)
+- Stopped using config helper inside config file (https://github.com/mpociot/laravel-apidoc-generator/pull/548)
+
+## [3.10.0] - Sunday, 23 June 2019
+### Added
+- `--verbose` flag to show exception encountered when making response calls (https://github.com/mpociot/laravel-apidoc-generator/commit/dc987f296e5a3d073f56c67911b2cb61ae47e9dc)
 
-## [2.1.2] - 10th September, 2018
+## [3.9.0] - Saturday, 8 June 2019
+### Modified
+- Postman collections and URLs in example requests now use the `apidoc.base_url` config variable (https://github.com/mpociot/laravel-apidoc-generator/pull/523)
+
+## [3.8.0] - Wednesday, 29 May 2019
+### Added
+- Support for PHP array callable syntax in route action (https://github.com/mpociot/laravel-apidoc-generator/pull/516)
+
+## [3.7.3] - Thursday, 23 May 2019
+### Fixed
+- Added faker_seed (https://github.com/mpociot/laravel-apidoc-generator/commit/d2901e51a68c17066d4dd96054ff5bfdf124945b)
+
+## [3.7.2] - Sunday, 19 May 2019
+### Added
+- Support for URL paths in include/exclude rules (https://github.com/mpociot/laravel-apidoc-generator/pull/507)
+
+## [3.7.1] - Friday, 17 May 2019
+### Fixed
+- Handle exception for no URL::forceRootURL() method in Lumen (https://github.com/mpociot/laravel-apidoc-generator/commit/2146fa114dc18bc32c00b5c5550266d753d5aef3)
+- Url parameter bindings (https://github.com/mpociot/laravel-apidoc-generator/commit/f0dc118c6b7792894bf9baa352d7fc4ca8ca74b5)
+
+## [3.7.0] - Thursday, 2 May 2019
+### Added
+- Support for `@queryParams` in Dingo FormRequests (https://github.com/mpociot/laravel-apidoc-generator/pull/506)
+- Easier customisation of example languages (https://github.com/mpociot/laravel-apidoc-generator/commit/0aa737a2e54a913eab4d024a1644c5ddd5dee8b8)
+- Include PHP as example language (https://github.com/mpociot/laravel-apidoc-generator/commit/c5814762fa52095fe645716554839b6ae110ef89)
+
+## [3.6.0] - Monday, 29 April 2019
+### Added
+- Support for `@queryParams` in FormRequests (https://github.com/mpociot/laravel-apidoc-generator/pull/504)
+- Added `default_group` key to replace `ungrouped_name` (https://github.com/mpociot/laravel-apidoc-generator/commit/72b5f546c1b84e69fe43c720a04f448c3b96e345)
+
+## [3.5.0] - Tuesday, 23 April 2019
+### Added
+- Option to seed faker for deterministic output (https://github.com/mpociot/laravel-apidoc-generator/pull/503)
+- Support for binding prefixes (https://github.com/mpociot/laravel-apidoc-generator/pull/498)
+- Ability to override Laravel `config` (https://github.com/mpociot/laravel-apidoc-generator/pull/496)
+- Allow override of the name 'general' for ungrouped routes (https://github.com/mpociot/laravel-apidoc-generator/pull/491)
+
+### Changed
+- Use parameter-bound URL in doc examples (https://github.com/mpociot/laravel-apidoc-generator/pull/500)
+
+### Fixed
+- Request router now matches when router has sub-domain (https://github.com/mpociot/laravel-apidoc-generator/pull/493)
+
+## [3.4.4] - Saturday, 30 March 2019
+### Fixed
+- Allow users specify custom Content-type header for Markdown examples (https://github.com/mpociot/laravel-apidoc-generator/pull/486)
+
+## [3.4.3] - Wednesday, 13 March 2019
+### Fixed
+- Ignore scalar type hints when checking for FormRequests (https://github.com/mpociot/laravel-apidoc-generator/pull/474)
+
+## [3.4.2] - Sunday, 10 March 2019
+### Added
+- Ability to set cookies on response calls (https://github.com/mpociot/laravel-apidoc-generator/pull/471)
+
+## [3.4.1] - Monday, 4 March 2019
+### Fixed
+- Support for Lumen 5.7 (https://github.com/mpociot/laravel-apidoc-generator/pull/467)
+
+## [3.4.0] - Wednesday, 27 February 2019
+### Added
+- Support for Laravel 5.8 (https://github.com/mpociot/laravel-apidoc-generator/pull/462)
+- Ability to annotate body parameters on FormRequest (https://github.com/mpociot/laravel-apidoc-generator/pull/460)
+
+
+## [3.3.2] - Tuesday, 12 February 2019
+### Added
+- Ability to specify array and object body/query params using dot notation (https://github.com/mpociot/laravel-apidoc-generator/pull/445)
+- Ability to specify name and description of Postman collection (https://github.com/mpociot/laravel-apidoc-generator/pull/443)
+
+### Fixed
+- Postman collection and documentation base URL now uses `config('app.url')` (https://github.com/mpociot/laravel-apidoc-generator/pull/458)
+
+## [3.3.1] - Tuesday, 8 January 2019
+### Fixed
+- Fixed vendor tags (https://github.com/mpociot/laravel-apidoc-generator/pull/444)
+
+## [3.3.0] - Wednesday, 2 January 2019
+### Added
+- Ability to replace json key values in response file (https://github.com/mpociot/laravel-apidoc-generator/pull/434)
+- Support for custom transfer serializers (https://github.com/mpociot/laravel-apidoc-generator/pull/441)
+
+## [3.2.0] - Wednesday, 12 December 2018
+### Changed
+- API groups are now sorted "naturally" (https://github.com/mpociot/laravel-apidoc-generator/pull/428)
+
+### Fixed
+- Partial resource controllers are now properly supported (https://github.com/mpociot/laravel-apidoc-generator/pull/429)
+- PUT request body now formatted as `urlencoded` in Postman collection (https://github.com/mpociot/laravel-apidoc-generator/pull/418)
+- `@responseFile` strategy now properly renders responses (https://github.com/mpociot/laravel-apidoc-generator/pull/427)
+
+## [3.1.1] - Wednesday, 5 December 2018
+### Added
+- Ability to specify different responses for different status codes. (https://github.com/mpociot/laravel-apidoc-generator/pull/416)
+
+## [3.1.0] - Wednesday, 28 November 2018
+### Added
+- Add `ResponseFileStrategy` to retrieve responses from files. (https://github.com/mpociot/laravel-apidoc-generator/pull/410)
+
+### Modified
+- Switch from `jQuery` to `fetch` in JavaScript examples. (https://github.com/mpociot/laravel-apidoc-generator/pull/411)
+
+## [3.0.6] - Saturday, 24 November 2018
+### Added
+- `include` and `exclude` route options now support wildcards (https://github.com/mpociot/laravel-apidoc-generator/pull/409)
+
+## [3.0.5] - Thursday, 15 November 2018
+### Fixed
+- Make `router` option case-insensitive (https://github.com/mpociot/laravel-apidoc-generator/pull/407)
+
+## [3.0.4] - Wednesday, 7 November 2018
+### Fixed
+- Replaced use of `Storage::copy` with PHP's `copy` to work with absolute paths (https://github.com/mpociot/laravel-apidoc-generator/pull/404)
+
+## [3.0.3] - Friday, 2 November 2018
+### Fixed
+- Replaced use of `config_path` with more generic option for better Lumen compatibility (https://github.com/mpociot/laravel-apidoc-generator/pull/398)
+
+## [3.0.2] - Friday, 26 October 2018
+### Added
+- Ability to specify examples for body and query parameters (https://github.com/mpociot/laravel-apidoc-generator/pull/394)
 ### Fixed
-- Set correct HTTP method when parsing FormRequest (https://github.com/mpociot/laravel-apidoc-generator/pull/314)
+- Rendering of example requests' descriptions (https://github.com/mpociot/laravel-apidoc-generator/pull/393)
 
-## [2.1.1] - 10th September, 2018
+## [3.0.1] - Monday, 22 October 2018
 ### Fixed
-- Print the correct file path of generated documentation (https://github.com/mpociot/laravel-apidoc-generator/pull/311)
-- Removed any extra slashes in URLs displayed in code samples (https://github.com/mpociot/laravel-apidoc-generator/pull/310)
-- Response calls are now also made for only GET in DIngo Router (https://github.com/mpociot/laravel-apidoc-generator/pull/309)
-- HEAD routes are no longer automatically generated for GET routes in DIngo Router (https://github.com/mpociot/laravel-apidoc-generator/pull/309)
+- Rendering of query parameters' descriptions (https://github.com/mpociot/laravel-apidoc-generator/pull/387)
 
-## [2.1.0] - 9th September, 2018
+## [3.0] - Sunday, 21 October 2018
 ### Added
-- Added support for multiple route domains (https://github.com/mpociot/laravel-apidoc-generator/pull/255) 
-- Added support for descriptions in custom validation rules (https://github.com/mpociot/laravel-apidoc-generator/pull/208)
-- Added support for multiple route prefixes (https://github.com/mpociot/laravel-apidoc-generator/pull/203)
-- Added support for formatting and `<aside>` tags (https://github.com/mpociot/laravel-apidoc-generator/pull/261)
-- Support for Laravel 5.5 auto-discovery (https://github.com/mpociot/laravel-apidoc-generator/pull/217)
+- Official Lumen support (https://github.com/mpociot/laravel-apidoc-generator/pull/382)
+- `@queryParam` annotation (https://github.com/mpociot/laravel-apidoc-generator/pull/383)
+- `@bodyParam` annotation (https://github.com/mpociot/laravel-apidoc-generator/pull/362, https://github.com/mpociot/laravel-apidoc-generator/pull/366)
+- `@authenticated` annotation (https://github.com/mpociot/laravel-apidoc-generator/pull/369)
+- Ability to override the controller `@group` from the method. (https://github.com/mpociot/laravel-apidoc-generator/pull/372)
+- Ability to use a custom logo (https://github.com/mpociot/laravel-apidoc-generator/pull/368)
 
 ### Changed
-- Response calls are now only made when route is GET (https://github.com/mpociot/laravel-apidoc-generator/pull/279)
-- Validator factory is now passed to `FormRequest::validator` method (https://github.com/mpociot/laravel-apidoc-generator/pull/236)
-- Bind optional model parameters in routes (https://github.com/mpociot/laravel-apidoc-generator/pull/297/)
-- HEAD routes are no longer automatically generated for GET routes (https://github.com/mpociot/laravel-apidoc-generator/pull/180)
-- `actAsUserId` option is no longer cast to an int (https://github.com/mpociot/laravel-apidoc-generator/pull/257)
+- Moved from command-line options to a config file  (https://github.com/mpociot/laravel-apidoc-generator/pull/362)
+- Commands have been renamed to the `apidoc` namespace (previously `api`). (https://github.com/mpociot/laravel-apidoc-generator/pull/350)
+- The `update` command has been renamed to `rebuild` and now uses the output path configured in the config file. (https://github.com/mpociot/laravel-apidoc-generator/pull/370)
+- `@resource` renamed to `@group` (https://github.com/mpociot/laravel-apidoc-generator/pull/371)
+- Added more configuration options for response calls (https://github.com/mpociot/laravel-apidoc-generator/pull/377)
 
 ### Fixed
-- `useMiddleware` option is now actually used (https://github.com/mpociot/laravel-apidoc-generator/pull/297/)
-- Changes to the info vendor view are now persisted (https://github.com/mpociot/laravel-apidoc-generator/pull/120)
-- Fixed memory leak issues (https://github.com/mpociot/laravel-apidoc-generator/pull/256)
-- Fixed issues with validating array parameters (https://github.com/mpociot/laravel-apidoc-generator/pull/299)
-- `@response` tag now parses content correctly as JSON (https://github.com/mpociot/laravel-apidoc-generator/pull/271)
 
 ### Removed
+- FormRequest parsing is no longer supported (https://github.com/mpociot/laravel-apidoc-generator/pull/362)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4da74e3f..9234426e 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,8 +1,6 @@
 # Contributing
 
-Contributions are **welcome** and will be fully **credited**.
-
-Please read and understand the contribution guide before creating an issue or pull request.
+Contributions are welcome.
 
 ## Etiquette
 
@@ -38,18 +36,14 @@ Before submitting a pull request:
 
 ## Requirements
 
-If the project maintainer has any additional requirements, you will find them listed here.
+- If your contribution changes the look of the generated documentation in some way, please include "before" and "after" screenshots in your pull request. 
 
-- **[PSR-2 Coding Standard](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)** - The easiest way to apply the conventions is to install [PHP Code Sniffer](http://pear.php.net/package/PHP_CodeSniffer).
+- Add a description to your pull request so the reviewer knows what to look out for before looking through your changes
 
 - **Add tests!** - Your patch won't be accepted if it doesn't have tests.
 
 - **Document any change in behaviour** - Make sure the `README.md` and any other relevant documentation are kept up-to-date.
 
-- **Consider our release cycle** - We try to follow [SemVer v2.0.0](http://semver.org/). Randomly breaking public APIs is not an option.
-
 - **One pull request per feature** - If you want to do more than one thing, send multiple pull requests.
 
-- **Send coherent history** - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please [squash them](http://www.git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Changing-Multiple-Commit-Messages) before submitting.
-
 **Happy coding**!
diff --git a/README.md b/README.md
index 3aa24e18..f5c6ed8f 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
 ## Laravel API Documentation Generator
 
-Automatically generate your API documentation from your existing Laravel routes. Take a look at the [example documentation](http://marcelpociot.de/whiteboard/).
+Automatically generate your API documentation from your existing Laravel/Lumen/[Dingo](https://github.com/dingo/api) routes.
 
-`php artisan api:gen --routePrefix="settings/api/*"`
+`php artisan apidoc:generate`
 
 [![Latest Stable Version](https://poser.pugx.org/mpociot/laravel-apidoc-generator/v/stable)](https://packagist.org/packages/mpociot/laravel-apidoc-generator)[![Total Downloads](https://poser.pugx.org/mpociot/laravel-apidoc-generator/downloads)](https://packagist.org/packages/mpociot/laravel-apidoc-generator)
 [![License](https://poser.pugx.org/mpociot/laravel-apidoc-generator/license)](https://packagist.org/packages/mpociot/laravel-apidoc-generator)
@@ -11,252 +11,40 @@ Automatically generate your API documentation from your existing Laravel routes.
 [![Build Status](https://travis-ci.org/mpociot/laravel-apidoc-generator.svg?branch=master)](https://travis-ci.org/mpociot/laravel-apidoc-generator)
 [![StyleCI](https://styleci.io/repos/57999295/shield?style=flat)](https://styleci.io/repos/57999295)
 
-
 ## Installation
+PHP 7.2 and Laravel/Lumen 5.7 or higher are required.
 
-Require this package with composer using the following command:
+> If your application does not meet these requirements, you can check out the 3.x branch for older releases.
 
 ```sh
-$ composer require mpociot/laravel-apidoc-generator
-```
-Using Laravel < 5.5? Go to your `config/app.php` and add the service provider:
-
-```php
-Mpociot\ApiDoc\ApiDocGeneratorServiceProvider::class,
-```
-
-> Using Laravel < 5.4? Use version 1.0! For Laravel 5.4 and up, use 2.0 instead.
-
-## Usage
-
-To generate your API documentation, use the `api:generate` artisan command.
-
-```sh
-$ php artisan api:generate --routePrefix="api/v1/*"
-
-```
-You can pass in multiple prefixes by spearating each prefix with comma.
-
-```sh
-$ php artisan api:generate --routePrefix="api/v1/*,api/public/*"
-```
-It will generate documentation for all of the routes whose prefixes are `api/v1/` and `api/public/`
-
-
-This command will scan your applications routes for the URIs matching `api/v1/*` and will parse these controller methods and form requests. For example:
-
-```php
-// API Group Routes
-Route::group(array('prefix' => 'api/v1', 'middleware' => []), function () {
-	// Custom route added to standard Resource
-	Route::get('example/foo', 'ExampleController@foo');
-	// Standard Resource route
-	Route::resource('example', 'ExampleController');
-});
-```
-
-### Available command options:
-
-Option | Description
---------- | -------
-`output` | The output path used for the generated documentation. Default: `public/docs`
-`routePrefix` | The route prefix(es) to use for generation. `*` can be used as a wildcard. Multiple route prefixes can be specified by separating them with a comma (for instance `/v1,/v2`)
-`routeDomain` | The route domain(s) to use for generation. `*` can be used as a wildcard. Multiple route domains can be specified by separating them with a comma 
-`routes` | The route names to use for generation - Required if no routePrefix or routeDomain is provided
-`middleware` | The middlewares to use for generation
-`noResponseCalls` | Disable API response calls
-`noPostmanCollection` | Disable Postman collection creation
-`useMiddlewares` | Use all configured route middlewares (Needed for Laravel 5.3 `SubstituteBindings` middleware)
-`actAsUserId` | The user ID to use for authenticated API response calls
-`router` | The router to use, when processing the route files (can be Laravel or Dingo - defaults to Laravel)
-`bindings` | List of route bindings that should be replaced when trying to retrieve route results. Syntax format: `binding_one,id|binding_two,id`
-`force` | Force the re-generation of existing/modified API routes
-`header` | Custom HTTP headers to add to the example requests. Separate the header name and value with ":". For example: `--header="Authorization: CustomToken"`
-
-## Publish rule descriptions for customisation or translation.
-
- By default, this package returns the descriptions in english. You can publish the packages language files, to customise and translate the documentation output.
-
- ```sh
- $ php artisan vendor:publish
- ```
-
- After the files are published you can customise or translate the descriptions in the language you want by renaming the `en` folder and editing the files in `public/vendor/apidoc/resources/lang`.
-
-
-### How does it work?
-
-This package uses these resources to generate the API documentation:
-
-#### Controller doc block
-
-This package uses the HTTP controller doc blocks to create a table of contents and show descriptions for your API methods.
-
-Using `@resource` in a doc block prior to each controller is useful as it creates a Group within the API documentation for all methods defined in that controller (rather than listing every method in a single list for all your controllers), but using `@resource` is not required. The short description after the `@resource` should be unique to allow anchor tags to navigate to this section. A longer description can be included below. Custom formatting and `<aside>` tags are also supported. (see the [Documentarian docs](http://marcelpociot.de/documentarian/installation/markdown_syntax))
-
-Above each method within the controller you wish to include in your API documentation you should have a doc block. This should include a unique short description as the first entry. An optional second entry can be added with further information. Both descriptions will appear in the API documentation in a different format as shown below.
-
-```php
-/**
- * @resource Example
- *
- * Longer description
- */
-class ExampleController extends Controller {
-
-	/**
-	 * This is the short description [and should be unique as anchor tags link to this in navigation menu]
-	 *
-	 * This can be an optional longer description of your API call, used within the documentation.
-	 *
-	 */
-	 public function foo(){
-
-	 }
-```
-
-**Result:** 
-
-![Doc block result](http://headsquaredsoftware.co.uk/images/api_generator_docblock.png)
-
-#### Form request validation rules
-
-To display a list of valid parameters, your API methods accepts, this package uses Laravel's [Form Requests Validation](https://laravel.com/docs/5.2/validation#form-request-validation).
-
-
-```php
-public function rules()
-{
-    return [
-        'title' => 'required|max:255',
-        'body' => 'required',
-        'type' => 'in:foo,bar',
-        'thumbnail' => 'required_if:type,foo|image',
-    ];
-}
+composer require --dev mpociot/laravel-apidoc-generator
 ```
 
-**Result:** ![Form Request](http://marcelpociot.de/documentarian/form_request.png)
-
-### A note on custom validation rules
-This package only supports custom rules defined as classes. You'll also need to define a `__toString()` method in the class, which should return the description that would be displayed in the generated doc.
-
-#### Controller method doc block
-It is possible to override the results for the response. This will also show the responses for other request methods then GET.
+### Laravel
+Publish the config file by running:
 
-#### @transformer
-With the transformer you can define the transformer that is used for the result of the method. It will try the next parts to get a result if it can find the transformer. The first successfull will be used.
-
-1. Check if there is a transformermodel tag to define the model
-2. Get a model from the modelfactory
-2. If the parameter is a Eloquent model it will load the first from the database.
-3. A new instance from the class
-
-```php
-/**
- * @transformer \Mpociot\ApiDoc\Tests\Fixtures\TestTransformer
- */
-public function transformerTag()
-{
-    return '';
-}
+```bash
+php artisan vendor:publish --provider="Mpociot\ApiDoc\ApiDocGeneratorServiceProvider" --tag=apidoc-config
 ```
 
-#### @transformercollection
-This is the same idea as the @tranformer tag with one different, instead of the return of an item, it will generate the return of a set with two items
+This will create an `apidoc.php` file in your `config` folder.
 
-```php
-/**
- * @transformercollection \Mpociot\ApiDoc\Tests\Fixtures\TestTransformer
- */
-public function transformerCollectionTag()
-{
-    return '';
-}
-```
-
-#### @transformermodel
-The @transformermodel tag is needed for PHP 5.* to get the model. For PHP 7 is it optional to specify the model that is used for the transformer.
-
-#### @response
-If you explicitly want to specify the result of a function you can set it in the docblock as JSON, using the `@response` annotation:
+### Lumen
+- When using Lumen, you will need to run `composer require mpociot/laravel-apidoc-generator` instead.
+- Register the service provider in your `bootstrap/app.php`:
 
 ```php
-/**
- * @response {
- *  "token": "eyJ0eXAi…",
- *  "roles": ["admin"]
- * }
- */
-public function responseTag()
-{
-    return '';
-}
-```
-
-#### API responses
-
-If your API route accepts a `GET` method, this package tries to call the API route with all middleware disabled to fetch an example API response. 
-
-If your API needs an authenticated user, you can use the `actAsUserId` option to specify a user ID that will be used for making these API calls:
-
-```sh
-$ php artisan api:generate --routePrefix="api/*" --actAsUserId=1
+$app->register(\Mpociot\ApiDoc\ApiDocGeneratorServiceProvider::class);
 ```
 
-If you don't want to automatically perform API response calls, use the `noResponseCalls` option.
-
-```sh
-$ php artisan api:generate --routePrefix="api/*" --noResponseCalls
-```
-
-> Note: The example API responses work best with seeded data.
-
-#### Postman collections
-
-The generator automatically creates a Postman collection file, which you can import to use within your [Postman App](https://www.getpostman.com/apps) for even simpler API testing and usage.
-
-If you don't want to create a Postman collection, use the `--noPostmanCollection` option, when generating the API documentation.
-
-As of Laravel 5.3, the default base URL added to the Postman collection will be that found in your Laravel `config/app.php` file. This will likely be `http://localhost`. If you wish to change this setting you can directly update the url or link this config value to your environment file to make it more flexible (as shown below):
+- Copy the config file from `vendor/mpociot/laravel-apidoc-generator/config/apidoc.php` to your project as `config/apidoc.php`. Then add to your `bootstrap/app.php`:
 
 ```php
-'url' => env('APP_URL', 'http://yourappdefault.app/'),
-```
-
-If you are referring to the environment setting as shown above, then you should ensure that you have updated your `.env` file to set the APP_URL value as appropriate. Otherwise the default value (`http://yourappdefault.app`) will be used in your Postman collection. Example environment value:
-
-```
-APP_URL=http://yourapp.app
+$app->configure('apidoc');
 ```
 
-## Modify the generated documentation
-
-If you want to modify the content of your generated documentation, go ahead and edit the generated `index.md` file.
-The default location of this file is: `public/docs/source/index.md`.
- 
-After editing the markdown file, use the `api:update` command to rebuild your documentation as a static HTML file.
-
-```sh
-$ php artisan api:update
-```
-
-As an optional parameter, you can use `--location` to tell the update command where your documentation can be found.
-
-## Automatically add markdown to the beginning or end of the documentation
- If you wish to automatically add the same content to the docs every time you generate, you can add a `prepend.md` and/or `append.md` file to the source folder, and they will be included above and below the generated documentation.
- 
- **File locations:**
-- `public/docs/source/prepend.md` - Will be added after the front matter and info text
-- `public/docs/source/append.md` - Will be added at the end of the document
-
-## Skip single routes
-
-If you want to skip a single route from a list of routes that match a given prefix, you can use the `@hideFromAPIDocumentation` tag on the Controller method you do not want to document.
-
-## Further modification
-
-This package uses [Documentarian](https://github.com/mpociot/documentarian) to generate the API documentation. If you want to modify the CSS files of your documentation, or simply want to learn more about what is possible, take a look at the [Documentarian guide](http://marcelpociot.de/documentarian/installation).
+## Documentation
+Check out the documentation at the [Beyond Code homepage](https://beyondco.de/docs/laravel-apidoc-generator/).
 
 ### License
 
diff --git a/body_params_1.png b/body_params_1.png
new file mode 100644
index 00000000..c1cecfe9
Binary files /dev/null and b/body_params_1.png differ
diff --git a/body_params_2.png b/body_params_2.png
new file mode 100644
index 00000000..eaaa79e9
Binary files /dev/null and b/body_params_2.png differ
diff --git a/composer.json b/composer.json
index a7fa4a08..9249c973 100644
--- a/composer.json
+++ b/composer.json
@@ -15,22 +15,33 @@
         }
     ],
     "require": {
-        "php": ">=5.5.0",
-        "fzaninotto/faker": "~1.0",
-        "laravel/framework": "~5.4",
-        "mpociot/documentarian": "^0.2.0",
-        "mpociot/reflection-docblock": "^1.0",
-        "ramsey/uuid": "^3.0"
+        "php": ">=7.2.0",
+        "ext-json": "*",
+        "fzaninotto/faker": "^1.8",
+        "illuminate/console": "^5.7|^6.0|^7.0|^8.0",
+        "illuminate/routing": "^5.7|^6.0|^7.0|^8.0",
+        "illuminate/support": "^5.7|^6.0|^7.0|^8.0",
+        "league/flysystem": "^1.0",
+        "mpociot/documentarian": "^0.4.0",
+        "mpociot/reflection-docblock": "^1.0.1",
+        "nunomaduro/collision": "^3.0|^4.0|^5.0",
+        "ramsey/uuid": "^3.8|^4.0",
+        "symfony/var-exporter": "^4.0|^5.0"
     },
     "require-dev": {
-        "orchestra/testbench": "~3.0",
-        "phpunit/phpunit": "~4.0 || ~5.0",
-        "dingo/api": "1.0.*@dev",
-        "mockery/mockery": "^0.9.5"
+        "dms/phpunit-arraysubset-asserts": "^0.1.0",
+        "laravel/lumen-framework": "^5.7|^6.0|^7.0|^8.0",
+        "league/fractal": "^0.19.0",
+        "orchestra/testbench": "^3.7|^4.0|^5.0",
+        "phpstan/phpstan": "^0.11.15",
+        "phpunit/phpunit": "^8.0"
+    },
+    "suggest": {
+        "league/fractal": "Required for transformers support"
     },
     "autoload": {
-        "psr-0": {
-            "Mpociot\\ApiDoc": "src/"
+        "psr-4": {
+            "Mpociot\\ApiDoc\\": "src/"
         }
     },
     "autoload-dev": {
@@ -39,13 +50,22 @@
         }
     },
     "scripts": {
-        "test-ci": "phpunit --coverage-clover=coverage.xml"
+        "lint": "phpstan analyse -c ./phpstan.neon src",
+        "test": "phpunit --stop-on-failure --exclude-group dingo",
+        "test-ci": "phpunit --exclude-group dingo"
     },
     "extra": {
         "laravel": {
             "providers": [
                 "Mpociot\\ApiDoc\\ApiDocGeneratorServiceProvider"
             ]
-       }
+        },
+        "branch-alias": {
+            "dev-v4": "4.x-dev"
+        }
+    },
+    "config": {
+        "preferred-install": "dist",
+        "sort-packages": true
     }
 }
diff --git a/config/apidoc.php b/config/apidoc.php
new file mode 100644
index 00000000..8ae737be
--- /dev/null
+++ b/config/apidoc.php
@@ -0,0 +1,293 @@
+<?php
+
+return [
+    /*
+     * The type of documentation output to generate.
+     * - "static" will generate a static HTMl page in the /public/docs folder,
+     * - "laravel" will generate the documentation as a Blade view,
+     * so you can add routing and authentication.
+     */
+    'type' => 'static',
+
+    /*
+     * Static output folder: HTML documentation and assets will be generated in this folder.
+     */
+   'output_folder' => 'public/docs',
+
+    /*
+     * Settings for `laravel` type output.
+     */
+    'laravel' => [
+        /*
+         * Whether to automatically create a docs endpoint for you to view your generated docs.
+         * If this is false, you can still set up routing manually.
+         */
+        'autoload' => false,
+
+        /*
+         * URL path to use for the docs endpoint (if `autoload` is true).
+         *
+         * By default, `/doc` opens the HTML page, and `/doc.json` downloads the Postman collection.
+         */
+        'docs_url' => '/doc',
+
+        /*
+         * Middleware to attach to the docs endpoint (if `autoload` is true).
+         */
+        'middleware' => [],
+    ],
+
+    /*
+     * The router to be used (Laravel or Dingo).
+     */
+    'router' => 'laravel',
+
+    /*
+     * The storage to be used when generating assets.
+     * By default, uses 'local'. If you are using Laravel Vapor, please use S3 and make sure
+     * the correct bucket is correctly configured in the .env file
+     */
+    'storage' => 'local',
+
+    /*
+     * The base URL to be used in examples and the Postman collection.
+     * By default, this will be the value of config('app.url').
+     */
+    'base_url' => null,
+
+    /*
+     * Generate a Postman collection in addition to HTML docs.
+     * For 'static' docs, the collection will be generated to public/docs/collection.json.
+     * For 'laravel' docs, it will be generated to storage/app/apidoc/collection.json.
+     * The `ApiDoc::routes()` helper will add routes for both the HTML and the Postman collection.
+     */
+    'postman' => [
+        /*
+         * Specify whether the Postman collection should be generated.
+         */
+        'enabled' => true,
+
+        /*
+         * The name for the exported Postman collection. Default: config('app.name')." API"
+         */
+        'name' => null,
+
+        /*
+         * The description for the exported Postman collection.
+         */
+        'description' => null,
+
+        /*
+         * The "Auth" section that should appear in the postman collection. See the schema docs for more information:
+         * https://schema.getpostman.com/json/collection/v2.0.0/docs/index.html
+         */
+        'auth' => null,
+    ],
+
+    /*
+     * The routes for which documentation should be generated.
+     * Each group contains rules defining which routes should be included ('match', 'include' and 'exclude' sections)
+     * and rules which should be applied to them ('apply' section).
+     */
+    'routes' => [
+        [
+            /*
+             * Specify conditions to determine what routes will be parsed in this group.
+             * A route must fulfill ALL conditions to pass.
+             */
+            'match' => [
+
+                /*
+                 * Match only routes whose domains match this pattern (use * as a wildcard to match any characters).
+                 */
+                'domains' => [
+                    '*',
+                    // 'domain1.*',
+                ],
+
+                /*
+                 * Match only routes whose paths match this pattern (use * as a wildcard to match any characters).
+                 */
+                'prefixes' => [
+                    '*',
+                    // 'users/*',
+                ],
+
+                /*
+                 * Match only routes registered under this version. This option is ignored for Laravel router.
+                 * Note that wildcards are not supported.
+                 */
+                'versions' => [
+                    'v1',
+                ],
+            ],
+
+            /*
+             * Include these routes when generating documentation,
+             * even if they did not match the rules above.
+             * Note that the route must be referenced by name here (wildcards are supported).
+             */
+            'include' => [
+                // 'users.index', 'healthcheck*'
+            ],
+
+            /*
+             * Exclude these routes when generating documentation,
+             * even if they matched the rules above.
+             * Note that the route must be referenced by name here (wildcards are supported).
+             */
+            'exclude' => [
+                // 'users.create', 'admin.*'
+            ],
+
+            /*
+             * Specify rules to be applied to all the routes in this group when generating documentation
+             */
+            'apply' => [
+                /*
+                 * Specify headers to be added to the example requests
+                 */
+                'headers' => [
+                    'Content-Type' => 'application/json',
+                    'Accept' => 'application/json',
+                    // 'Authorization' => 'Bearer {token}',
+                    // 'Api-Version' => 'v2',
+                ],
+
+                /*
+                 * If no @response or @transformer declarations are found for the route,
+                 * we'll try to get a sample response by attempting an API call.
+                 * Configure the settings for the API call here.
+                 */
+                'response_calls' => [
+                    /*
+                     * API calls will be made only for routes in this group matching these HTTP methods (GET, POST, etc).
+                     * List the methods here or use '*' to mean all methods. Leave empty to disable API calls.
+                     */
+                    'methods' => ['GET'],
+
+                    /*
+                     * Laravel config variables which should be set for the API call.
+                     * This is a good place to ensure that notifications, emails
+                     * and other external services are not triggered
+                     * during the documentation API calls
+                     */
+                    'config' => [
+                        'app.env' => 'documentation',
+                        'app.debug' => false,
+                        // 'service.key' => 'value',
+                    ],
+
+                    /*
+                     * Cookies which should be sent with the API call.
+                     */
+                    'cookies' => [
+                        // 'name' => 'value'
+                    ],
+
+                    /*
+                     * Query parameters which should be sent with the API call.
+                     */
+                    'queryParams' => [
+                        // 'key' => 'value',
+                    ],
+
+                    /*
+                     * Body parameters which should be sent with the API call.
+                     */
+                    'bodyParams' => [
+                        // 'key' => 'value',
+                    ],
+                ],
+            ],
+        ],
+    ],
+
+    'strategies' => [
+        'metadata' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\Metadata\GetFromDocBlocks::class,
+        ],
+        'urlParameters' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\UrlParameters\GetFromUrlParamTag::class,
+        ],
+        'queryParameters' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\QueryParameters\GetFromQueryParamTag::class,
+        ],
+        'headers' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\RequestHeaders\GetFromRouteRules::class,
+        ],
+        'bodyParameters' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\BodyParameters\GetFromBodyParamTag::class,
+        ],
+        'responses' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseTransformerTags::class,
+            \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseResponseTag::class,
+            \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseResponseFileTag::class,
+            \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseApiResourceTags::class,
+            \Mpociot\ApiDoc\Extracting\Strategies\Responses\ResponseCalls::class,
+        ],
+    ],
+
+    /*
+     * Custom logo path. The logo will be copied from this location
+     * during the generate process. Set this to false to use the default logo.
+     *
+     * Change to an absolute path to use your custom logo. For example:
+     * 'logo' => resource_path('views') . '/api/logo.png'
+     *
+     * If you want to use this, please be aware of the following rules:
+     * - the image size must be 230 x 52
+     */
+    'logo' => false,
+
+    /*
+     * Name for the group of routes which do not have a @group set.
+     */
+    'default_group' => 'general',
+
+    /*
+     * Example requests for each endpoint will be shown in each of these languages.
+     * Supported options are: bash, javascript, php, python
+     * You can add a language of your own, but you must publish the package's views
+     * and define a corresponding view for it in the partials/example-requests directory.
+     * See https://laravel-apidoc-generator.readthedocs.io/en/latest/generating-documentation.html
+     *
+     */
+    'example_languages' => [
+        'bash',
+        'javascript',
+    ],
+
+    /*
+     * Configure how responses are transformed using @transformer and @transformerCollection
+     * Requires league/fractal package: composer require league/fractal
+     *
+     */
+    'fractal' => [
+        /* If you are using a custom serializer with league/fractal,
+         * you can specify it here.
+         *
+         * Serializers included with league/fractal:
+         * - \League\Fractal\Serializer\ArraySerializer::class
+         * - \League\Fractal\Serializer\DataArraySerializer::class
+         * - \League\Fractal\Serializer\JsonApiSerializer::class
+         *
+         * Leave as null to use no serializer or return a simple JSON.
+         */
+        'serializer' => null,
+    ],
+
+    /*
+     * If you would like the package to generate the same example values for parameters on each run,
+     * set this to any number (eg. 1234)
+     *
+     */
+    'faker_seed' => null,
+
+    /*
+     * If you would like to customize how routes are matched beyond the route configuration you may
+     * declare your own implementation of RouteMatcherInterface
+     *
+     */
+    'routeMatcher' => \Mpociot\ApiDoc\Matching\RouteMatcher::class,
+];
diff --git a/dingo.composer.json b/dingo.composer.json
new file mode 100644
index 00000000..83004b63
--- /dev/null
+++ b/dingo.composer.json
@@ -0,0 +1,71 @@
+{
+    "name": "mpociot/laravel-apidoc-generator",
+    "license": "MIT",
+    "description": "Generate beautiful API documentation from your Laravel application",
+    "keywords": [
+        "API",
+        "Documentation",
+        "Laravel"
+    ],
+    "homepage": "http://github.com/mpociot/laravel-apidoc-generator",
+    "authors": [
+        {
+            "name": "Marcel Pociot",
+            "email": "m.pociot@gmail.com"
+        }
+    ],
+    "require": {
+        "php": ">=7.2.0",
+        "ext-json": "*",
+        "fzaninotto/faker": "^1.8",
+        "illuminate/console": "^5.7|^6.0|^7.0|^8.0",
+        "illuminate/routing": "^5.7|^6.0|^7.0|^8.0",
+        "illuminate/support": "^5.7|^6.0|^7.0|^8.0",
+        "league/flysystem": "^1.0",
+        "mpociot/documentarian": "^0.4.0",
+        "mpociot/reflection-docblock": "^1.0.1",
+        "nunomaduro/collision": "^3.0|^4.0|^5.0",
+        "ramsey/uuid": "^3.8|^4.0",
+        "symfony/var-exporter": "^4.0|^5.0"
+    },
+    "require-dev": {
+        "dingo/api": "^2.3",
+        "dms/phpunit-arraysubset-asserts": "^0.1.0",
+        "league/fractal": "^0.17.0",
+        "orchestra/testbench": "^3.7|^4.0|^5.0",
+        "phpstan/phpstan": "^0.11.15",
+        "phpunit/phpunit": "^8.0"
+    },
+    "suggest": {
+        "league/fractal": "Required for transformers support"
+    },
+    "autoload": {
+        "psr-4": {
+            "Mpociot\\ApiDoc\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Mpociot\\ApiDoc\\Tests\\": "tests/"
+        }
+    },
+    "scripts": {
+        "lint": "phpstan analyse -c ./phpstan.neon src",
+        "test": "phpunit --stop-on-failure --group dingo",
+        "test-ci": "phpunit --group dingo"
+    },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "Mpociot\\ApiDoc\\ApiDocGeneratorServiceProvider"
+            ]
+        },
+        "branch-alias": {
+            "dev-v4": "4.x-dev"
+        }
+    },
+    "config": {
+        "preferred-install": "dist",
+        "sort-packages": true
+    }
+}
diff --git a/docs/_index.md b/docs/_index.md
new file mode 100644
index 00000000..8dcb342b
--- /dev/null
+++ b/docs/_index.md
@@ -0,0 +1,4 @@
+---
+packageName: Laravel API Documentation Generator
+githubUrl: https://github.com/mpociot/laravel-apidoc-generator
+---
\ No newline at end of file
diff --git a/docs/extending/_index.md b/docs/extending/_index.md
new file mode 100644
index 00000000..cf3041a7
--- /dev/null
+++ b/docs/extending/_index.md
@@ -0,0 +1,4 @@
+---
+title: Extending
+order: 2
+---
diff --git a/docs/extending/plugins.md b/docs/extending/plugins.md
new file mode 100644
index 00000000..ac3b343a
--- /dev/null
+++ b/docs/extending/plugins.md
@@ -0,0 +1,178 @@
+---
+title: Plugins
+order: 1
+---
+# Extending functionality with plugins
+You can use plugins to alter how the Generator fetches data about your routes. For instance, suppose all your routes have a body parameter `organizationId`, and you don't want to annotate this with `@queryParam` on each method. You can create a plugin that adds this to all your body parameters. Let's see how to do this.
+
+## The stages of route processing
+Route processing is performed in six stages:
+- metadata (this covers route `title`, route `description`, route `groupName`, route `groupDescription`, and authentication status (`authenticated`))
+- urlParameters
+- queryParameters
+- headers (headers to be added to example request and response calls)
+- bodyParameters
+- responses
+
+For each stage, the Generator attempts the specified strategies to fetch data. The Generator will call of the strategies configured, progressively combining their results together before to produce the final output of that stage.
+
+There are a number of strategies included with the package, so you don't have to set up anything to get it working.
+
+> Note: The included ResponseCalls strategy is designed to stop if a response with a 2xx status code has already been gotten via any other strategy.
+
+## Strategies
+To create a strategy, create a class that extends `\Mpociot\ApiDoc\Extracting\Strategies\Strategy`.
+
+The `__invoke` method of the strategy is where you perform your actions and return data. It receives the following arguments:
+- the route (instance of `\Illuminate\Routing\Route`)
+- the controller class handling the route (`\ReflectionClass`)
+- the controller method (`\ReflectionMethod $method`)
+ - the rules specified in the apidoc.php config file for the group this route belongs to, under the `apply` section (array)
+ - the context. This contains all data for the route that has been parsed thus far in the previous stages. This means, by the `responses` stage, the context will contain the following keys: `metadata`, `bodyParameters` and `queryParameters`.
+ 
+ Here's what your strategy in our example would look like:
+ 
+ ```php
+use Illuminate\Routing\Route;
+use Mpociot\ApiDoc\Extracting\Strategies\Strategy;
+
+class AddOrganizationIdBodyParameter extends Strategy
+{
+    public function __invoke(Route $route, \ReflectionClass $controller, \ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        return [
+            'organizationId' => [
+                'type' => 'integer',
+                'description' => 'The ID of the organization', 
+                'required' => true, 
+                'value' => 2,
+            ]
+        ];
+    }
+}
+```
+
+The last thing to do is to register the strategy. Strategies are registered in a `strategies` key in the `apidoc.php` file. Here's what the file looks like by default:
+
+```php
+...
+    'strategies' => [
+        'metadata' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\Metadata\GetFromDocBlocks::class,
+        ],
+        'urlParameters' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\UrlParameters\GetFromUrlParamTag::class,
+        ],
+        'queryParameters' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\QueryParameters\GetFromQueryParamTag::class,
+        ],
+        'headers' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\RequestHeaders\GetFromRouteRules::class,
+        ],
+        'bodyParameters' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\BodyParameters\GetFromBodyParamTag::class,
+        ],
+        'responses' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseTransformerTags::class,
+            \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseResponseTag::class,
+            \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseResponseFileTag::class,
+            \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseApiResourceTags::class,
+            \Mpociot\ApiDoc\Extracting\Strategies\Responses\ResponseCalls::class,
+        ],
+    ],
+...
+```
+
+You can add, replace or remove strategies from here. In our case, we're adding our bodyParameter strategy:
+
+```php
+
+        'bodyParameters' => [
+            \Mpociot\ApiDoc\Extracting\Strategies\BodyParameters\GetFromBodyParamTag::class,
+            AddOrganizationIdBodyParameter::class,
+        ],
+```
+
+And we're done. Now, when we run `php artisan docs:generate`, all our routes will have this bodyParameter added.
+
+
+We could go further and modify our strategy so it doesn't add this parameter if the route is a GET route or is authenticated:
+
+```php
+public function __invoke(Route $route, \ReflectionClass $controller, \ReflectionMethod $method, array $routeRules, array $context = [])
+{
+    if (in_array('GET', $route->methods()) {
+        return null;
+    }
+
+    if ($context['metadata']['authenticated']) {
+        return null;
+    }
+
+    return [
+        'organizationId' => [
+            'type' => 'integer',
+            'description' => 'The ID of the organization', 
+            'required' => true, 
+            'value' => 2,
+        ]
+    ];
+}
+```
+
+> Note: If you would like a parameter (body or query) to be included in the documentation but excluded from examples, set its `value` property to `null`.
+
+The strategy class also has access to the current apidoc configuration via its `config` property. For instance, you can retrieve the default group with `$this->config->get('default_group')`.
+
+You are also provided with the instance pproperty `stage`, which is set to the name of the currently executing stage.
+
+
+## Utilities
+You have access to a number of tools when developing strategies. They include:
+
+- The `RouteDocBlocker` class (in the `\Mpociot\ApiDoc\Extracting` namespace) has a single public static method, `getDocBlocksFromRoute(Route $route)`. It allows you to retrieve the docblocks for a given route. It returns an array of with two keys: `method` and `class` containing the docblocks for the method and controller handling the route respectively. Both are instances of `\Mpociot\Reflection\DocBlock`.
+
+- The `ParamsHelper` trait (in the `\Mpociot\ApiDoc\Extracting` namespace) can be included in your strategies. It contains a number of useful methods for working with parameters, including type casting and generating dummy values.
+
+## API
+Each strategy class must implement the __invoke method with the parameters as described above. This method must return the needed data for the intended stage, or `null` to indicate failure.
+- In the `metadata` stage, strategies should return an array. These are the expected keys (you may omit some, or all):
+
+```
+'groupName'
+'groupDescription'
+'title'
+'description'
+'authenticated' // boolean
+```
+
+- In the `bodyParameters` and `queryParameters` stages, you can return an array with arbitrary keys. These keys will serve as the names of your parameters. Array keys can be indicated with Laravel's dot notation. The value of each key should be an array with the following keys:
+
+```
+'type', // Only valid in bodyParameters
+'description', 
+'required', // boolean
+'value', // An example value for the parameter
+```
+- In the `responses` stage, your strategy should return an array containing the responses for different status codes. Each item in the array should be an array representing the response with a `status` key containing the HTTP status code, and a `content` key a string containing the response. For example:
+
+```php
+
+    public function __invoke(Route $route, \ReflectionClass $controller, \ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        return [
+            [
+                'content' => "Haha",
+                'status' => 201
+            ],
+            [
+                'content' => "Nope",
+                'status' => 404
+            ],
+        ]
+    }
+```
+
+Responses are _additive_. This means all the responses returned from each stage are added to the `responses` array. But note that the `ResponseCalls` strategy will only attempt to fetch a response if there are no responses with a status code of 2xx already.
+
+- In the `headers` stage, you can return an array of headers. You may also negate existing headers by providing `false` as the header value.
diff --git a/docs/getting-started/_index.md b/docs/getting-started/_index.md
new file mode 100644
index 00000000..7f67f577
--- /dev/null
+++ b/docs/getting-started/_index.md
@@ -0,0 +1,4 @@
+---
+title: Getting Started
+order: 1
+---
diff --git a/docs/getting-started/configuration.md b/docs/getting-started/configuration.md
new file mode 100644
index 00000000..b2d4c640
--- /dev/null
+++ b/docs/getting-started/configuration.md
@@ -0,0 +1,252 @@
+---
+title: Configuration
+order: 2
+---
+# Configuration
+
+Before you can generate your documentation, you'll need to configure a few things in your `config/apidoc.php` file. 
+
+If you aren't sure what an option does, it's best to leave it set to the default.
+
+## type
+This is the type of documentation output to generate.  
+
+`static` will generate a static HTML page in the `public/docs` folder, so anyone can visit your documentation page by going to {yourapp.domain}/docs.
+
+`laravel` will generate the documentation as a Blade view within the `resources/views/apidoc` folder, so you can add routing and authentication to your liking.
+
+> In both instances, the source markdown file will be generated in `resources/docs/source`.
+
+### laravel
+If you're using `laravel` type output, this package can automatically set up an endpoint for you to view your generated docs. You can configure this here.
+
+### autoload
+Set this to `true` if you want the documentation endpoint to be automatically set up for you. Default: `false`
+
+You may, of course, use your own routing instead of using `autoload`.
+
+### docs_url
+The path for the documentation endpoint (if `autoload` is true). Your Postman collection (if you have that enabled) will be at this path + '.json' (eg `/doc.json`). Default: `/doc`
+
+> Note: There is currently a known issue with using `/docs` as the path for `laravel` docs. You should not use it, as it conflicts with the folder structure in the `public` folder and may confuse the webserver.
+
+## middleware
+Here, you can specify middleware to be attached to the documentation endpoint (if `autoload` is true).
+
+## router
+The router to use when processing your routes (can be Laravel or Dingo. Defaults to **Laravel**)
+
+## base_url
+The base URL to be used in examples and the Postman collection. By default, this will be the value of config('app.url').
+
+## postman
+This package can automatically generate a Postman collection for your routes, along with the documentation. This section is where you can configure (or disable) that.
+
+For `static` docs (see [type](#type)), the collection will be created in `public/docs/collection.json`, so it can be accessed by visiting {yourapp.domain}/docs/colllection.json.
+
+For `laravel` docs, the collection will be generated to `storage/app/apidoc/collection.json`. The `ApiDoc::routes()` helper will add a `/docs.json` endpoint to fetch it..
+
+### enabled
+Whether or not to generate a Postman API collection. Default: **true**
+
+### name
+The name for the exported Postman collection. If you leave this as null, this package will default to `config('app.name')." API"`.
+
+### description
+The description for the generated Postman collection.
+
+## logo
+You can specify a custom logo to be used on the generated documentation. Set the `logo` option to an absolute path pointing to your logo file. For example:
+```
+'logo' => resource_path('views') . '/api/logo.png'
+```
+
+If you want to use this, please note that the image size must be 230 x 52.
+
+## default_group
+When [documenting your api](/docs/laravel-apidoc-generator/getting-started/documenting-your-api), you use `@group` annotations to group API endpoints. Endpoints which do not have a group annotation will be grouped under the `default_group`. Defaults to **"general"**.
+
+## example_languages
+For each endpoint, an example request is shown in each of the languages specified in this array. Currently only `bash`, `javascript`, `php` and `python` are supported. You can add your own language, but you must also define the corresponding view (see [Specifying languages for examples](/docs/laravel-apidoc-generator/getting-started/generating-documentation)). Default: `["bash", "javascript"]` 
+ 
+##  faker_seed
+When generating example requests, this package uses fzanninoto/faker to generate random values. If you would like the package to generate the same example values for parameters on each run, set this to any number (eg. 1234). (Note: alternatively, you can set example values for parameters when [documenting them.](/docs/laravel-apidoc-generator/getting-started/documenting-your-api))
+
+## routeMatcher
+The route matcher class provides the algorithm that determines what routes should be documented. The default matcher used is the included `\Mpociot\ApiDoc\Matching\RouteMatcher::class`, and you can provide your own custom implementation if you wish to programmatically change the algorithm. The provided matcher must be an instance of the `RouteMatcherInterface`.
+       
+## fractal
+This section only applies if you're using Transformers for your API, and documenting responses with `@transformer` and `@transformerCollection`. Here, you configure how responses are transformed.
+
+> Note: using transformers requires league/fractal package. Run `composer require league/fractal to install
+
+
+### serializer
+If you are using a custom serializer with league/fractal,  you can specify it here. league/fractal comes with the following serializers:
+- \League\Fractal\Serializer\ArraySerializer::class
+- \League\Fractal\Serializer\DataArraySerializer::class
+- \League\Fractal\Serializer\JsonApiSerializer::class
+
+Leave this as null to use no serializer or return a simple JSON.
+
+## routes
+The `routes` section is an array of items, describing what routes in your application that should have documentation generated for them. Each item in the array contains rules about what routes belong in that group, and what rules to apply to them. This allows you to apply different settings to different routes.
+
+> Note: This package does not work with Closure-based routes. If you want your route to be captured by this package, you need a controller.
+
+Each item in the `routes` array (a route group) has keys which are explained below. We'll use this sample route definition for a Laravel app to demonstrate them:
+
+```php
+Route::group(['domain' => 'api.acme.co'], function () {
+  Route::get('/apps', 'AppController@listApps')
+    ->name('apps.list');
+  Route::get('/apps/{id}', 'AppController@getApp')
+    ->name('apps.get');
+  Route::post('/apps', 'AppController@createApp')
+    ->name('apps.create');
+  Route::get('/users', 'UserController@listUsers')
+    ->name('users.list');
+  Route::get('/users/{id}', 'UserController@getUser')
+    ->name('users.get');
+});
+
+Route::group(['domain' => 'public-api.acme.co'], function () {
+  Route::get('/stats', 'PublicController@getStats')
+    ->name('public.stats');
+});
+
+Route::group(['domain' => 'status.acme.co'], function () {
+  Route::get('/status', 'PublicController@getStatus')
+    ->name('status');
+});
+```
+
+### match
+In this section, you define the rules that will be used to determine what routes in your application fall into this group. There are three kinds of rules defined here (keys in the `match` array):
+
+### domains
+This key takes an array of domain names as its value. Only routes which are defined on the domains specified here will be matched as part of this group. For instance, in our sample routes above, we may wish to apply different settings to documentation based on the domains. For instance, the routes on the `api.acme.co` domain need authentication, while those on the other domains do not. We can separate them into two groups like this:
+
+```php
+return [
+  //...,
+  
+  'routes' => [
+    [
+      'match' => [
+        'domains' => ['api.acme.co'],
+        'prefixes' => ['*'],
+      ],
+      'apply' => [
+        'headers' => [ 'Authorization' => 'Bearer {your-token}']
+      ]
+    ],
+    [
+      'match' => [
+        'domains' => ['public-api.acme.co', 'status.acme.co'],
+        'prefixes' => ['*'],
+      ],
+    ],
+  ],
+];
+```
+The first group will match all routes on the 'api.acme.co' domain, and add a header 'Authorization: Bearer {your-token}' to the examples in the generated documentation. The second group will pick up the other routes. The Authorization header will not be added for those ones.
+
+You can use the `*` wildcard to match all domains (or as a placeholder in a pattern).
+
+### prefixes
+The prefixes key is similar to the `domains` key, but is based on URL path prefixes (ie. what the part starts with, after the domain name). You could use prefixes to rewrite our example configuration above in a different way:
+
+```php
+return [
+  //...,
+  
+  'routes' => [
+    [
+      'match' => [
+         'domains' => ['*'],
+         'prefixes' => ['users/*', 'apps/*'],
+       ],
+       'apply' => [
+         'headers' => [ 'Authorization' => 'Bearer {your-token}']
+       ]
+    ],
+    [
+      'match' => [
+         'domains' => ['*'],
+         'prefixes' => ['stats/*', 'status/*'],
+      ],
+    ],
+  ],
+];
+```
+
+This would achieve the same as the first configuration. As with domains, the `*` character is a wildcard. This means you can set up a ingle group to match all your routes by using `'domains' => ['*'], 'prefixes' => ['*']`. (This is set by default.)
+
+> The `domains` and `prefixes` keys are both required for all route groups.
+
+### versions
+> This section only applies if you're using Dingo Router
+
+When using Dingo's Router, all routes must be specified inside versions. This means that you must specify the versions to be matched along with the domains and prefixes when describing a route group. Note that wildcards in `versions` are not supported; you must list out all your versions explicitly. Example:
+
+ ```php
+return [
+  //...,
+  
+  'routes' => [
+    [
+      'match' => [
+        'domains' => ['*'],
+        'prefixes' => ['*'],
+        'versions' => ['v1', 'beta'], // only if you're using Dingo router
+      ],
+    ],
+  ],
+];
+```
+
+### include and exclude
+
+The `include` key holds an array of patterns (route names or paths) which should be included in this group, *even if they do not match the rules in the match section*.
+
+The `exclude` key holds an array of patterns (route names or paths) which should be excluded from this group, *even if they match the rules in the match section*.
+
+Using our above sample routes, assuming you wanted to place the `users.list` route in the second group (no Authorization header), here's how you could do it:
+
+```php
+return [
+  //...,
+  
+  'routes' => [
+    [
+      'match' => [
+        'domains' => ['api.acme.co'],
+        'prefixes' => ['*'],
+      ],
+      'exclude' => ['users.list'],
+      'apply' => [
+        'headers' => [ 'Authorization' => 'Bearer {your-token}']
+      ]
+    ],
+    [
+      'match' => [
+        'domains' => ['public-api.acme.co', 'status.acme.co'],
+        'prefixes' => ['*'],
+      ],
+      'include' => ['users.list'],
+    ],
+  ],
+];
+```
+
+These values support wildcards and paths, so you can have `'exclude' => ['users/*']` to exclude all routes with URLs matching the pattern.
+
+### apply
+After defining the routes in `match` (and `include` or `exclude`), `apply` is where you specify the settings to be applied to those routes when generating documentation. There are a bunch of settings you can tweak here:
+
+### headers
+Like we've demonstrated above, any headers you specify here will be added to the headers shown in the example requests in your documentation. They will also be included in ["response calls"](/docs/laravel-apidoc-generator/getting-started/documenting-your-api). Headers are specified as key => value strings.
+
+### response_calls
+These are the settings that will be applied when making ["response calls"](/docs/laravel-apidoc-generator/getting-started/documenting-your-api). See the linked section for details.
diff --git a/docs/getting-started/documenting-your-api.md b/docs/getting-started/documenting-your-api.md
new file mode 100644
index 00000000..c11a4600
--- /dev/null
+++ b/docs/getting-started/documenting-your-api.md
@@ -0,0 +1,355 @@
+---
+title: Documenting Your API
+order: 4
+---
+# Documenting Your API
+This package generates documentation from your code using mainly annotations (in doc block comments).
+
+## Grouping endpoints
+All endpoints are grouped for easy organization. Using `@group` in a controller doc block creates a Group within the API documentation. All routes handled by that controller will be grouped under this group in the table of contents shown in the sidebar. 
+
+The short description after the `@group` should be unique to allow anchor tags to navigate to this section. A longer description can be included below. Custom formatting and `<aside>` tags are also supported. (see the [Documentarian docs](http://marcelpociot.de/documentarian/installation/markdown_syntax))
+
+ > Note: using `@group` is optional. Ungrouped routes will be placed in a default group.
+
+Above each route in the controller, you should have a doc block. This should include a unique short description as the first entry. An optional second entry can be added with further information. Both descriptions will appear in the API documentation in a different format as shown below.
+
+You can also specify an `@group` on a single method to override the group defined at the controller level.
+
+```php
+/**
+ * @group User management
+ *
+ * APIs for managing users
+ */
+class UserController extends Controller
+{
+
+	/**
+	 * Create a user
+	 *
+	 * [Insert optional longer description of the API endpoint here.]
+	 *
+	 */
+	 public function createUser()
+	 {
+
+	 }
+	 
+	/**
+	 * @group Account management
+	 *
+	 */
+	 public function changePassword()
+	 {
+
+	 }
+}
+```
+
+**Result:** 
+
+![Doc block result](/img/api_generator_docblock.png)
+
+## Specifying request parameters
+To specify a list of valid parameters your API route accepts, use the `@urlParam`, `@bodyParam` and `@queryParam` annotations.
+- The `@urlParam` annotation is used for describing parameters in your URl. For instance, in a Laravel route with this URL: "/post/{id}/{lang?}", you would use this annotation to describe the `id` and `lang` parameters. It takes the name of the parameter, an optional "required" label, and then its description.
+- The `@queryParam` annotation takes the name of the parameter, an optional "required" label, and then its description.
+- The `@bodyParam` annotation takes the name of the parameter, its type, an optional "required" label, and then its description. 
+
+Examples:
+
+```php
+/**
+ * @urlParam id required The ID of the post.
+ * @urlParam lang The language.
+ * @bodyParam user_id int required The id of the user. Example: 9
+ * @bodyParam room_id string The id of the room.
+ * @bodyParam forever boolean Whether to ban the user forever. Example: false
+ * @bodyParam another_one number Just need something here.
+ * @bodyParam yet_another_param object required Some object params.
+ * @bodyParam yet_another_param.name string required Subkey in the object param.
+ * @bodyParam even_more_param array Some array params.
+ * @bodyParam even_more_param.* float Subkey in the array param.
+ * @bodyParam book.name string
+ * @bodyParam book.author_id integer
+ * @bodyParam book[pages_count] integer
+ * @bodyParam ids.* integer
+ * @bodyParam users.*.first_name string The first name of the user. Example: John
+ * @bodyParam users.*.last_name string The last name of the user. Example: Doe
+ */
+public function createPost()
+{
+    // ...
+}
+
+/**
+ * @queryParam sort Field to sort by
+ * @queryParam page The page number to return
+ * @queryParam fields required The fields to include
+ */
+public function listPosts()
+{
+    // ...
+}
+```
+
+They will be included in the generated documentation text and example requests.
+
+### Example parameters
+For each parameter in your request, this package will generate a random value to be used in the example requests. If you'd like to specify an example value, you can do so by adding `Example: your-example` to the end of your description. For instance:
+
+```php
+    /**
+     * @queryParam location_id required The id of the location.
+     * @queryParam user_id required The id of the user. Example: me
+     * @queryParam page required The page number. Example: 4
+     * @bodyParam user_id int required The id of the user. Example: 9
+     * @bodyParam room_id string The id of the room.
+     * @bodyParam forever boolean Whether to ban the user forever. Example: false
+     */
+```
+
+You can also exclude a particular parameter from the generated examples (for all languages) by annotating it with `No-example`. For instance:
+```php
+    /**
+    * @queryParam location_id required The id of the location. Example: 1
+    * @queryParam user_id required The id of the user. No-example
+    * @queryParam page required The page number. Example: 4
+    */
+```
+Outputs: 
+```bash
+curl -X GET -G "https://example.com/api?location_id=1&page=4"
+```
+
+Note: You can also add the `@queryParam` and `@bodyParam` annotations to a `\Illuminate\Foundation\Http\FormRequest` subclass instead, if you are using one in your controller method
+
+```php
+/**
+ * @queryParam user_id required The id of the user. Example: me
+ * @bodyParam title string required The title of the post.
+ * @bodyParam body string required The content of the post.
+ * @bodyParam type string The type of post to create. Defaults to 'textophonious'.
+ * @bodyParam author_id int the ID of the author. Example: 2
+ * @bodyParam thumbnail image This is required if the post type is 'imagelicious'.
+ */
+class MyRequest extends \Illuminate\Foundation\Http\FormRequest
+{
+
+}
+
+// in your controller...
+public function createPost(MyRequest $request)
+{
+    // ...
+}
+```
+
+## Indicating authentication status
+You can use the `@authenticated` annotation on a method to indicate if the endpoint is authenticated. A "Requires authentication" badge will be added to that route in the generated documentation.
+
+Just like `@group` annotation, you can also specify an `@authenticated` on a single method to override the authenticated status defined at the controller level.
+
+```php
+/**
+ * @authenticated
+ *
+ * APIs for managing users
+ */
+class UserController extends Controller
+{
+
+	/**
+	 * Create a user
+	 *
+	 * [Insert optional longer description of the API endpoint here.]
+	 *
+	 */
+	 public function createUser()
+	 {
+
+	 }
+	 
+	/**
+	 * @group Account management
+	 *
+	 */
+	 public function changePassword()
+	 {
+
+	 }
+}
+```
+
+Now all the methods under this controller will have "Requires authentication" badge enabled.
+
+## Providing an example response
+You can provide an example response for a route. This will be displayed in the examples section. There are several ways of doing this.
+
+### @response
+You can provide an example response for a route by using the `@response` annotation with valid JSON:
+
+```php
+/**
+ * @response {
+ *  "id": 4,
+ *  "name": "Jessica Jones",
+ *  "roles": ["admin"]
+ * }
+ */
+public function show($id)
+{
+    return User::find($id);
+}
+```
+
+Moreover, you can define multiple `@response` tags as well as the HTTP status code related to a particular response (if no status code set, `200` will be assumed):
+```php
+/**
+ * @response {
+ *  "id": 4,
+ *  "name": "Jessica Jones",
+ *  "roles": ["admin"]
+ * }
+ * @response 404 {
+ *  "message": "No query results for model [\App\User]"
+ * }
+ */
+public function show($id)
+{
+    return User::findOrFail($id);
+}
+```
+
+### @apiResource, @apiResourceCollection, and @apiResourceModel
+If your controller method uses [Eloquent API resources](https://laravel.com/docs/5.8/eloquent-resources), you can use the apiResource annotations to guide the package when generating a sample response. The `@apiResource` tag specifies the name of the resource. Use `@apiResourceCollection` instead if the route returns a list. This works with both regular `JsonResource` objects and `ResourceCollection` objects.
+ 
+ The `@apiResourceModel` specifies the Eloquent model to be passed to the resource. The package will attempt to generate an instance of the model for the resource from the Eloquent model factory. If that fails, the package will call `::first()` to retrieve the first model from the database. If that fails, it will create an instance using `new`.
+
+Examples:
+
+```php
+
+/**
+ * @apiResourceCollection Mpociot\ApiDoc\Tests\Fixtures\UserResource
+ * @apiResourceModel Mpociot\ApiDoc\Tests\Fixtures\User
+ */
+public function listUsers()
+{
+    return UserResource::collection(User::all());
+}
+
+/**
+ * @apiResourceCollection Mpociot\ApiDoc\Tests\Fixtures\UserCollection
+ * @apiResourceModel Mpociot\ApiDoc\Tests\Fixtures\User
+ */
+public function listMoreUsers()
+{
+    return new UserCollection(User::all());
+}
+
+/**
+ * @apiResourceCollection Mpociot\ApiDoc\Tests\Fixtures\UserResource
+ * @apiResourceModel Mpociot\ApiDoc\Tests\Fixtures\User
+ */
+public function showUser(User $user)
+{
+    return new UserResource($user);
+}
+```
+
+### @transformer, @transformerCollection, and @transformerModel
+You can define the transformer that is used for the result of the route using the `@transformer` tag (or `@transformerCollection` if the route returns a list). The package will attempt to generate an instance of the model to be transformed using the following steps, stopping at the first successful one:
+
+1. Check if there is a `@transformerModel` tag to define the model being transformed. If there is none, use the class of the first parameter to the transformer's `transform()` method.
+2. Get an instance of the model from the Eloquent model factory
+2. If the parameter is an Eloquent model, load the first from the database.
+3. Create an instance using `new`.
+
+Finally, it will pass in the model to the transformer and display the result of that as the example response.
+
+For example:
+
+```php
+/**
+ * @transformercollection \App\Transformers\UserTransformer
+ * @transformerModel \App\User
+ */
+public function listUsers()
+{
+    //...
+}
+
+/**
+ * @transformer \App\Transformers\UserTransformer
+ */
+public function showUser(User $user)
+{
+    //...
+}
+
+/**
+ * @transformer \App\Transformers\UserTransformer
+ * @transformerModel \App\User
+ */
+public function showUser(int $id)
+{
+    // ...
+}
+```
+For the first route above, this package will generate a set of two users then pass it through the transformer. For the last two, it will generate a single user and then pass it through the transformer.
+
+> Note: for transformer support, you need to install the league/fractal package
+
+```bash
+composer require league/fractal
+```
+
+### @responseFile
+
+For large response bodies, you may want to use a dump of an actual response. You can put this response in a file (as a JSON string) within your Laravel storage directory and link to it. For instance, we can put this response in a file named `users.get.json` in `storage/responses`:
+
+```
+{"id":5,"name":"Jessica Jones","gender":"female"}
+```
+
+Then in your controller, link to it by:
+
+```php
+/**
+ * @responseFile responses/users.get.json
+ */
+public function getUser(int $id)
+{
+  // ...
+}
+```
+The package will parse this response and display in the examples for this route.
+
+Similarly to `@response` tag, you can provide multiple `@responseFile` tags along with the HTTP status code of the response:
+```php
+/**
+ * @responseFile responses/users.get.json
+ * @responseFile 404 responses/model.not.found.json
+ */
+public function getUser(int $id)
+{
+  // ...
+}
+```
+
+## Generating responses automatically
+If you don't specify an example response using any of the above means, this package will attempt to get a sample response by making a request to the route (a "response call"). A few things to note about response calls:
+
+- Response calls are done within a database transaction and changes are rolled back afterwards.
+
+- The configuration for response calls is located in the `config/apidoc.php`. They are configured within the `apply.response_calls` section for each route group, allowing you to apply different settings for different sets of routes.
+
+- By default, response calls are only made for GET routes, but you can configure this. Set the `methods` key to an array of methods or '*' to mean all methods. Leave it as an empty array to turn off response calls for that route group.
+
+- You can set Laravel config variables. This is useful so you can prevent external services like notifications from being triggered. By default the `app.env` is set to 'documentation'. You can add more variables in the `config` key.
+
+- By default, the package will generate dummy values for your documented body and query parameters and send in the request. If you specified example values using `@bodyParam` or `@queryParam`, those will be used instead. You can configure additional parameters or overwrite the existing ones for the request in the `queryParams`, and `bodyParams` sections.
+
+- The `ResponseCalls` strategy will only attempt to fetch a response if there are no responses with a status code of 2xx already.
diff --git a/docs/getting-started/generating-documentation.md b/docs/getting-started/generating-documentation.md
new file mode 100644
index 00000000..4deecda9
--- /dev/null
+++ b/docs/getting-started/generating-documentation.md
@@ -0,0 +1,76 @@
+---
+title: Generating Documentation
+order: 5
+---
+# Generating Documentation
+
+To generate your API documentation, use the `apidoc:generate` artisan command.
+
+```sh
+php artisan apidoc:generate
+```
+
+It will generate documentation using your specified configuration. The documentation will be generated as static HTML and CSS assets within the specified output folder.
+
+## Regenerating
+When you make changes to your routes, you can safely regenerate your documentation by running the `generate` command. This will rewrite the documentation for only the routes you have changed. You can use the `force` option to force the regeneration of existing/unmodified API routes.
+
+## Postman collections
+
+The generator automatically creates a Postman collection file, which you can import to use within your [Postman app](https://www.getpostman.com/apps) for even simpler API testing and usage.
+
+If you don't want to create a Postman collection, set the `postman.enabled` config option to false.
+
+The base URL used in the Postman collection will be the value of the `base_url` key in your Laravel `config/apidoc.php` file. 
+
+## Manually modifying the content of the generated documentation
+If you want to modify the content of your generated documentation without changing the routes, go ahead and edit the generated `index.md` file.
+
+This file is located in the `source` folder of  your `output` directory (see configuration), so by default, this is `public/docs/source/index.md`.
+ 
+After editing the markdown file, you can use the `apidoc:rebuild` command to rebuild your documentation into HTML.
+
+```sh
+php artisan apidoc:rebuild
+```
+
+## Automatically add markdown to the beginning or end of the documentation
+ If you wish to automatically add the same content to the docs every time you generate (for instance, an introduction, a disclaimer or an authenticatino guide), you can add a `prepend.md` and/or `append.md` file to the `source` folder in the source output directory (`resources/docs/source`), and they will be added to the generated documentation. 
+ 
+ The contents of `prepend.md` will be added after the front matter and info text, while the contents of `append.md` will be added at the end of the document.
+ 
+ ## Specifying language for examples
+ For each endpoint, an example request is shown in each language configured. To add a language which is not supported by this package, you'll have to create your own view for how an example should render. Here's how:
+ 
+ - Publish the vendor views by running:
+ 
+ ```bash
+ php artisan vendor:publish --provider="Mpociot\ApiDoc\ApiDocGeneratorServiceProvider" --tag=apidoc-views
+ ```
+ 
+ This will copy the views files to `\resources\views\vendor\apidoc`.
+ 
+ - Next, create a file called {language-name}.blade.php (for example, ruby.blade.php) in the partials/example-requests directory. You can then write Markdown with Blade templating that describes how the example request for the language should be rendered. You have the `$route` variable available to you. This variable is an array with the following keys:
+- `methods`: an array of the HTTP methods for that route
+- `boundUri`: the complete URL for the route, with any url parameters replaced (/users/{id} -> /users/1)
+- `headers`: key-value array of headers to be sent with route (according to your configuration)
+- `cleanQueryParameters`: key-value array of query parameters with example values to be sent with the request. Parameters which have been excluded from the example requests (see Example Parameters at Documenting your API) will not be present here.
+- `cleanBodyParameters`: key-value array of body parameters with example values to be sent with the request. Parameters which have been excluded from the example requests (see Example Parameters at Documenting your API will not be present here.
+
+- Add the language to the `example_languages` array in the package config.
+
+- Generate your documentation 
+
+To customise existing language templates you can perform the `vendor:publish` command above, then modify the blade templates in `resources/` as necessary.
+
+## Memory Limitations
+
+Generating docs for large APIs can be memory intensive. If you run into memory limits, consider running PHP with command line flags to increase memory limit or update your CLI php.ini file:
+
+```
+php -d memory_limit=1G artisan apidoc:generate
+```
+
+## Further modification
+
+This package uses [Documentarian](https://github.com/mpociot/documentarian) to generate the API documentation. If you want to modify the CSS files of your documentation, or simply want to learn more about what is possible, take a look at the [Documentarian guide](http://marcelpociot.de/documentarian/installation).
diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
new file mode 100644
index 00000000..87c86b41
--- /dev/null
+++ b/docs/getting-started/installation.md
@@ -0,0 +1,35 @@
+---
+title: Installation
+order: 1
+---
+
+# Installation
+
+You can install Laravel API Documentation Generator using composer:
+
+```bash
+composer require mpociot/laravel-apidoc-generator
+```
+
+## Laravel
+Publish the config file by running:
+
+```bash
+php artisan vendor:publish --provider="Mpociot\ApiDoc\ApiDocGeneratorServiceProvider" --tag=apidoc-config
+```
+This will create an `apidoc.php` file in your `config` folder.
+
+## Lumen
+Register the service provider in your `bootstrap/app.php`:
+
+```php
+$app->register(\Mpociot\ApiDoc\ApiDocGeneratorServiceProvider::class);
+```
+
+Next, copy the config file from `vendor/mpociot/laravel-apidoc-generator/config/apidoc.php` to your project as `config/apidoc.php`. 
+
+Then add to your `bootstrap/app.php`:
+
+```php
+$app->configure('apidoc');
+```
\ No newline at end of file
diff --git a/docs/getting-started/migrating.md b/docs/getting-started/migrating.md
new file mode 100644
index 00000000..7112f39b
--- /dev/null
+++ b/docs/getting-started/migrating.md
@@ -0,0 +1,40 @@
+---
+title: Migrating from v3 to v4
+order: 10
+---
+
+# Migrating
+Note: This isn't meant to be an exhaustive guide to the changes in v4. Please see the changelog for more details (and full list of new features).
+
+## Requirements
+- PHP version: 7.2+
+- Laravel/Lumen version: 5.7+
+
+## Configuration 
+- Rename your old config file (for instance to `apidoc.old.php`). Publish the new config file via `php artisan vendor:publish --provider="Mpociot\ApiDoc\ApiDocGeneratorServiceProvider" --tag=apidoc-config`. Then copy over any changes you've made in the old one and delete it when you're done.
+
+- Remove the `output` key. Source files now go to `resources/docs/source` and generated docs go to either `public/docs/` or `resources/views/apidoc`.
+
+- Make sure the `type` value is set appropriately. See [the docs](/docs/laravel-apidoc-generator/getting-started/configuration). 
+
+- Remove the `bindings` section. It has been superseded by the `@urlParam` annotation, which works similarly to the existing `@queryParam` annotation. See [the docs](/docs/laravel-apidoc-generator/getting-started/documenting-your-api)
+
+- Remove the `response_calls.bindings` section. Use the `Example: ` feature of `@urlParam` to specify the value you want to be used in response calls.
+
+- Rename the `query` and `body` sections in `response_calls` section to `queryParams` and `bodyParams`
+
+- Remove the `apply.response_calls.headers`. Move any headers you had there to `apply.headers` 
+
+## Assets
+- If you've published the vendor views, rename them (for instance to `route.old.blade.php`). Publish the new views via `php artisan vendor:publish --provider="Mpociot\ApiDoc\ApiDocGeneratorServiceProvider" --tag=apidoc-views`. Compare the two views and reconcile your changes, then delete the old views. Some of the data being passed to the views (the `$route` object) has changed in either name or format, so things will likely break if you use old views.
+The major change here is the introduction of the `urlParameters` section and the collapsing of route `title`, `description`, `groupName`, `groupDescription`, and authentication status (`authenticated` into a `metadata` section.
+
+- The location of the source files for the generated docs has changed. Move any prepend/append files you've created from `public/docs/source` to the new location (`resources/docs/source`)
+
+## API
+- Verify that any custom strategies you've written match the new signatures. See [the docs](/docs/laravel-apidoc-generator/extending/plugins). Also note the order of execution and the new stages present.
+
+## Other new features (highlights)
+- [Non-static docs/docs with authentication](/docs/laravel-apidoc-generator/getting-started/configuration)
+- [`@apiResource` for Eloquent API resources](/docs/laravel-apidoc-generator/getting-started/documenting-your-api)
+- You can now mix and match response strategies and status codes as you like.
diff --git a/docs/under-the-hood/_index.md b/docs/under-the-hood/_index.md
new file mode 100644
index 00000000..84027be5
--- /dev/null
+++ b/docs/under-the-hood/_index.md
@@ -0,0 +1,4 @@
+---
+title: Under the hood
+order: 3
+---
diff --git a/docs/under-the-hood/architecture.md b/docs/under-the-hood/architecture.md
new file mode 100644
index 00000000..bb0f6d4f
--- /dev/null
+++ b/docs/under-the-hood/architecture.md
@@ -0,0 +1,16 @@
+---
+title: Architecture
+order: 3
+---
+# Architecture
+Read this page if you want a deeper understanding of how this works (for instance, for the purpose of contributing).
+
+- When the `generate` command is run, it fetches all your application's routes from Laravel's (or DIngo's) Route facade.
+- Next, the RouteMatcher uses the rules in your config to determine what routes to generate documentation for, as well as extract any specific configuration for them. This configuration is passed to the next stages.
+- The Generator processes each route. This entails:
+  - Fetching the route action (controller, method) via Reflection (along with their corresponding docblocks). These are used in the remaining stages below.
+  - Determining and obtaining info on body parameters, query parameters and headers to be added to the route's documentation.
+  - Obtaining a sample response.
+- The generate command uses information from these parsed routes and other configuration to generate a Markdown file via Blade templating.
+- This Markdown file is passed to Documentarian, which transforms it into HTML, CSS and JavaScript assets.
+- If enabled, a Postman collection is generated as well.
diff --git a/docs/under-the-hood/how-it-works.md b/docs/under-the-hood/how-it-works.md
new file mode 100644
index 00000000..dc7e54b3
--- /dev/null
+++ b/docs/under-the-hood/how-it-works.md
@@ -0,0 +1,14 @@
+---
+title: How This Works
+order: 2
+---
+
+# How This Works
+
+After installing this package and running the command `php artisan apidoc:generate` in your application, here's what happens:
+
+- The package fetches all your application's routes.
+- It looks through your configuration file to filter the routes to the ones you actually want to document. For each route, it retrieves the settings you want to apply to it, if any.
+- It processes each route. "Process" here involves using a number of strategies to extract the route's information: group, title, description, body parameters, query parameters, and a sample response, if possible.
+- After processing the routes, it generates a markdown file describing the routes from the parsed data and passes them to [Documentarian](https://github.com/mpociot/documentarian), which wraps them in a theme and converts them into HTML and CSS.
+- It generates a Postman API collection for your routes. This can be disabled.
diff --git a/phpstan.neon b/phpstan.neon
new file mode 100644
index 00000000..122c7957
--- /dev/null
+++ b/phpstan.neon
@@ -0,0 +1,14 @@
+parameters:
+    level: 5
+    reportUnmatchedIgnoredErrors: false
+    inferPrivatePropertyTypeFromConstructor: true
+    ignoreErrors:
+        - '#Call to an undefined static method Illuminate\\Support\\Facades\\Route::getRoutes().#'
+        - '#Call to an undefined static method Illuminate\\Support\\Facades\\URL::forceRootUrl()#'
+        - '#Call to an undefined static method Illuminate\\Support\\Facades\\URL::formatRoot()#'
+        - '#Cannot access offset .+ on Illuminate\\Contracts\\Foundation\\Application.#'
+        - '#Call to an undefined method Illuminate\\Routing\\Route::versions().#'
+        - '#(.*)NunoMaduro\\Collision(.*)#'
+        - '#Instantiated class Whoops\\Exception\\Inspector not found\.#'
+        - '#.+Dingo.+#'
+        - '#Call to an undefined method Illuminate\\Contracts\\Filesystem\\Filesystem::url()#'
diff --git a/phpunit.xml b/phpunit.xml
index 1458c056..a006d680 100644
--- a/phpunit.xml
+++ b/phpunit.xml
@@ -7,8 +7,7 @@
          convertNoticesToExceptions="true"
          convertWarningsToExceptions="true"
          processIsolation="false"
-         stopOnFailure="true"
-         syntaxCheck="false">
+         stopOnFailure="false">
     <testsuites>
         <testsuite name="Versionable Suite">
             <directory>tests/</directory>
@@ -16,10 +15,10 @@
     </testsuites>
     <filter>
         <whitelist>
-            <directory suffix=".php">src/Mpociot/</directory>
+            <directory suffix=".php">src/</directory>
             <exclude>
-                <file>src/Mpociot/ApiDoc/ApiDocGeneratorServiceProvider.php</file>
-                <file>src/resources/views/documentarian.blade.php</file>
+                <file>src/ApiDocGeneratorServiceProvider.php</file>
+                <file>resources/views/documentarian.blade.php</file>
             </exclude>
         </whitelist>
     </filter>
diff --git a/src/resources/views/documentarian.blade.php b/resources/views/documentarian.blade.php
similarity index 55%
rename from src/resources/views/documentarian.blade.php
rename to resources/views/documentarian.blade.php
index d1bb3463..ff8e69e1 100644
--- a/src/resources/views/documentarian.blade.php
+++ b/resources/views/documentarian.blade.php
@@ -5,10 +5,10 @@
 {!! $infoText !!}
 <!-- END_INFO -->
 {!! $prependMd !!}
-@foreach($parsedRoutes as $group => $routes)
-@if($group)
-#{!! $group !!}
-@endif
+@foreach($parsedRoutes as $groupName => $routes)
+#{!! $groupName !!}
+{{-- We pick the first non-empty description we see. --}}
+{!! \Illuminate\Support\Arr::first($routes, function ($route) { return $route['metadata']['groupDescription'] !== ''; })['metadata']['groupDescription'] ?? '' !!}
 @foreach($routes as $parsedRoute)
 @if($writeCompareFile === true)
 {!! $parsedRoute['output'] !!}
diff --git a/resources/views/partials/example-requests/bash.blade.php b/resources/views/partials/example-requests/bash.blade.php
new file mode 100644
index 00000000..5237be86
--- /dev/null
+++ b/resources/views/partials/example-requests/bash.blade.php
@@ -0,0 +1,13 @@
+```bash
+curl -X {{$route['methods'][0]}} \
+    {{$route['methods'][0] == 'GET' ? '-G ' : ''}}"{{ rtrim($baseUrl, '/')}}/{{ ltrim($route['boundUri'], '/') }}@if(count($route['cleanQueryParameters']))?{!! \Mpociot\ApiDoc\Tools\Utils::printQueryParamsAsString($route['cleanQueryParameters']) !!}@endif" @if(count($route['headers']))\
+@foreach($route['headers'] as $header => $value)
+    -H "{{$header}}: {{ addslashes($value) }}"@if(! ($loop->last) || ($loop->last && count($route['bodyParameters']))) \
+@endif
+@endforeach
+@endif
+@if(count($route['cleanBodyParameters']))
+    -d '{!! json_encode($route['cleanBodyParameters']) !!}'
+@endif
+
+```
diff --git a/resources/views/partials/example-requests/javascript.blade.php b/resources/views/partials/example-requests/javascript.blade.php
new file mode 100644
index 00000000..11b59569
--- /dev/null
+++ b/resources/views/partials/example-requests/javascript.blade.php
@@ -0,0 +1,41 @@
+```javascript
+const url = new URL(
+    "{{ rtrim($baseUrl, '/') }}/{{ ltrim($route['boundUri'], '/') }}"
+);
+@if(count($route['cleanQueryParameters']))
+
+let params = {!! \Mpociot\ApiDoc\Tools\Utils::printQueryParamsAsKeyValue($route['cleanQueryParameters'], "\"", ":", 4, "{}") !!};
+Object.keys(params)
+    .forEach(key => url.searchParams.append(key, params[key]));
+@endif
+
+@if(!empty($route['headers']))
+let headers = {
+@foreach($route['headers'] as $header => $value)
+    "{{$header}}": "{{$value}}",
+@endforeach
+@if(!array_key_exists('Accept', $route['headers']))
+    "Accept": "application/json",
+@endif
+@if(!array_key_exists('Content-Type', $route['headers']))
+    "Content-Type": "application/json",
+@endif
+};
+@endif
+@if(count($route['cleanBodyParameters']))
+
+let body = {!! json_encode($route['cleanBodyParameters'], JSON_PRETTY_PRINT) !!}
+@endif
+
+fetch(url, {
+    method: "{{$route['methods'][0]}}",
+@if(count($route['headers']))
+    headers: headers,
+@endif
+@if(count($route['bodyParameters']))
+    body: body
+@endif
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
+```
diff --git a/resources/views/partials/example-requests/php.blade.php b/resources/views/partials/example-requests/php.blade.php
new file mode 100644
index 00000000..0c162a2d
--- /dev/null
+++ b/resources/views/partials/example-requests/php.blade.php
@@ -0,0 +1,24 @@
+```php
+
+$client = new \GuzzleHttp\Client();
+@if($hasRequestOptions)
+$response = $client->{{ strtolower($route['methods'][0]) }}(
+    '{{ rtrim($baseUrl, '/') . '/' . ltrim($route['boundUri'], '/') }}',
+    [
+@if(!empty($route['headers']))
+        'headers' => {!! \Mpociot\ApiDoc\Tools\Utils::printPhpValue($route['headers'], 8) !!},
+@endif
+@if(!empty($route['cleanQueryParameters']))
+        'query' => {!! \Mpociot\ApiDoc\Tools\Utils::printQueryParamsAsKeyValue($route['cleanQueryParameters'], "'", "=>", 12, "[]", 8) !!},
+@endif
+@if(!empty($route['cleanBodyParameters']))
+        'json' => {!! \Mpociot\ApiDoc\Tools\Utils::printPhpValue($route['cleanBodyParameters'], 8) !!},
+@endif
+    ]
+);
+@else
+$response = $client->{{ strtolower($route['methods'][0]) }}('{{ rtrim($baseUrl, '/') . '/' . ltrim($route['boundUri'], '/') }}');
+@endif
+$body = $response->getBody();
+print_r(json_decode((string) $body));
+```
diff --git a/resources/views/partials/example-requests/python.blade.php b/resources/views/partials/example-requests/python.blade.php
new file mode 100644
index 00000000..ac78f226
--- /dev/null
+++ b/resources/views/partials/example-requests/python.blade.php
@@ -0,0 +1,23 @@
+```python
+import requests
+import json
+
+url = '{{ rtrim($baseUrl, '/') }}/{{ ltrim($route['boundUri'], '/') }}'
+@if(count($route['cleanBodyParameters']))
+payload = {!! json_encode($route['cleanBodyParameters'], JSON_PRETTY_PRINT) !!}
+@endif
+@if(count($route['cleanQueryParameters']))
+params = {!! \Mpociot\ApiDoc\Tools\Utils::printQueryParamsAsKeyValue($route['cleanQueryParameters'], "'", ":", 2, "{}") !!}
+@endif
+@if(!empty($route['headers']))
+headers = {
+@foreach($route['headers'] as $header => $value)
+  '{{$header}}': '{{$value}}'@if(!($loop->last)),
+@endif
+@endforeach
+
+}
+@endif
+response = requests.request('{{$route['methods'][0]}}', url{{ count($route['headers']) ?', headers=headers' : '' }}{{ count($route['cleanBodyParameters']) ? ', json=payload' : '' }}{{ count($route['cleanQueryParameters']) ? ', params=params' : ''}})
+response.json()
+```
diff --git a/src/resources/views/partials/frontmatter.blade.php b/resources/views/partials/frontmatter.blade.php
similarity index 69%
rename from src/resources/views/partials/frontmatter.blade.php
rename to resources/views/partials/frontmatter.blade.php
index c53f337c..f89d1253 100644
--- a/src/resources/views/partials/frontmatter.blade.php
+++ b/resources/views/partials/frontmatter.blade.php
@@ -1,8 +1,9 @@
 title: API Reference
 
 language_tabs:
-- bash
-- javascript
+@foreach($settings['languages'] as $language)
+- {{ $language }}
+@endforeach
 
 includes:
 
diff --git a/src/resources/views/partials/info.blade.php b/resources/views/partials/info.blade.php
similarity index 100%
rename from src/resources/views/partials/info.blade.php
rename to resources/views/partials/info.blade.php
diff --git a/resources/views/partials/route.blade.php b/resources/views/partials/route.blade.php
new file mode 100644
index 00000000..2afd4dd3
--- /dev/null
+++ b/resources/views/partials/route.blade.php
@@ -0,0 +1,65 @@
+<!-- START_{{$route['id']}} -->
+@if($route['metadata']['title'] != '')## {{ $route['metadata']['title']}}
+@else## {{$route['uri']}}@endif
+@if($route['metadata']['authenticated'])
+
+<br><small style="padding: 1px 9px 2px;font-weight: bold;white-space: nowrap;color: #ffffff;-webkit-border-radius: 9px;-moz-border-radius: 9px;border-radius: 9px;background-color: #3a87ad;">Requires authentication</small>@endif
+@if($route['metadata']['description'])
+
+{!! $route['metadata']['description'] !!}
+@endif
+
+> Example request:
+
+@foreach($settings['languages'] as $language)
+@include("apidoc::partials.example-requests.$language")
+
+@endforeach
+
+@if(in_array('GET',$route['methods']) || (isset($route['showresponse']) && $route['showresponse']))
+@foreach($route['responses'] as $response)
+> Example response ({{$response['status']}}):
+
+```json
+@if(is_object($response['content']) || is_array($response['content']))
+{!! json_encode($response['content'], JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) !!}
+@else
+{!! json_encode(json_decode($response['content']), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) !!}
+@endif
+```
+@endforeach
+@endif
+
+### HTTP Request
+@foreach($route['methods'] as $method)
+`{{$method}} {{$route['uri']}}`
+
+@endforeach
+@if(count($route['urlParameters']))
+#### URL Parameters
+
+Parameter | Status | Description
+--------- | ------- | ------- | -------
+@foreach($route['urlParameters'] as $attribute => $parameter)
+    `{{$attribute}}` | @if($parameter['required']) required @else optional @endif | {!! $parameter['description'] !!}
+@endforeach
+@endif
+@if(count($route['queryParameters']))
+#### Query Parameters
+
+Parameter | Status | Description
+--------- | ------- | ------- | -----------
+@foreach($route['queryParameters'] as $attribute => $parameter)
+    `{{$attribute}}` | @if($parameter['required']) required @else optional @endif | {!! $parameter['description'] !!}
+@endforeach
+@endif
+@if(count($route['bodyParameters']))
+#### Body Parameters
+Parameter | Type | Status | Description
+--------- | ------- | ------- | ------- | -----------
+@foreach($route['bodyParameters'] as $attribute => $parameter)
+    `{{$attribute}}` | {{$parameter['type']}} | @if($parameter['required']) required @else optional @endif | {!! $parameter['description'] !!}
+    @endforeach
+@endif
+
+<!-- END_{{$route['id']}} -->
diff --git a/routes/laravel.php b/routes/laravel.php
new file mode 100644
index 00000000..64ffb592
--- /dev/null
+++ b/routes/laravel.php
@@ -0,0 +1,13 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+
+$prefix = config('apidoc.laravel.docs_url', '/doc');
+$middleware = config('apidoc.laravel.middleware', []);
+
+Route::namespace('\Mpociot\ApiDoc\Http')
+    ->middleware($middleware)
+    ->group(function () use ($prefix) {
+        Route::get($prefix, 'Controller@html')->name('apidoc');
+        Route::get("$prefix.json", 'Controller@json')->name('apidoc.json');
+    });
diff --git a/src/ApiDoc.php b/src/ApiDoc.php
new file mode 100644
index 00000000..b6bec8e3
--- /dev/null
+++ b/src/ApiDoc.php
@@ -0,0 +1,36 @@
+<?php
+
+namespace Mpociot\ApiDoc;
+
+use Illuminate\Support\Facades\Route;
+
+class ApiDoc
+{
+    /**
+     * Binds the ApiDoc routes into the controller.
+     *
+     * @deprecated Use autoload routes instead (`config/apidoc.php`: `laravel > autoload`).
+     *
+     * @param string $path
+     */
+    public static function routes($path = '/doc')
+    {
+        Route::prefix($path)
+            ->namespace('\Mpociot\ApiDoc\Http')
+            ->middleware(static::middleware())
+            ->group(function () {
+                Route::get('/', 'Controller@html')->name('apidoc');
+                Route::get('.json', 'Controller@json')->name('apidoc.json');
+            });
+    }
+
+    /**
+     * Get the middlewares for Laravel routes.
+     *
+     * @return array
+     */
+    protected static function middleware()
+    {
+        return config('apidoc.laravel.middleware', []);
+    }
+}
diff --git a/src/ApiDocGeneratorServiceProvider.php b/src/ApiDocGeneratorServiceProvider.php
new file mode 100644
index 00000000..78595b8c
--- /dev/null
+++ b/src/ApiDocGeneratorServiceProvider.php
@@ -0,0 +1,59 @@
+<?php
+
+namespace Mpociot\ApiDoc;
+
+use Illuminate\Support\ServiceProvider;
+use Mpociot\ApiDoc\Commands\GenerateDocumentation;
+use Mpociot\ApiDoc\Commands\RebuildDocumentation;
+use Mpociot\ApiDoc\Matching\RouteMatcher;
+use Mpociot\ApiDoc\Matching\RouteMatcherInterface;
+
+class ApiDocGeneratorServiceProvider extends ServiceProvider
+{
+    /**
+     * Bootstrap the application events.
+     *
+     * @return void
+     */
+    public function boot()
+    {
+        $this->loadViewsFrom(__DIR__ . '/../resources/views/', 'apidoc');
+
+        $this->publishes([
+            __DIR__ . '/../resources/views' => $this->app->basePath('resources/views/vendor/apidoc'),
+        ], 'apidoc-views');
+
+        $this->publishes([
+            __DIR__ . '/../config/apidoc.php' => $this->app->configPath('apidoc.php'),
+        ], 'apidoc-config');
+
+        $this->mergeConfigFrom(__DIR__ . '/../config/apidoc.php', 'apidoc');
+
+        $this->bootRoutes();
+
+        if ($this->app->runningInConsole()) {
+            $this->commands([
+                GenerateDocumentation::class,
+                RebuildDocumentation::class,
+            ]);
+        }
+
+        // Bind the route matcher implementation
+        $this->app->bind(RouteMatcherInterface::class, config('apidoc.routeMatcher', RouteMatcher::class));
+    }
+
+    /**
+     * Initializing routes in the application.
+     */
+    protected function bootRoutes()
+    {
+        if (
+            config('apidoc.type', 'static') === 'laravel' &&
+            config('apidoc.laravel.autoload', false)
+        ) {
+            $this->loadRoutesFrom(
+                __DIR__ . '/../routes/laravel.php'
+            );
+        }
+    }
+}
diff --git a/src/Commands/GenerateDocumentation.php b/src/Commands/GenerateDocumentation.php
new file mode 100644
index 00000000..783c7019
--- /dev/null
+++ b/src/Commands/GenerateDocumentation.php
@@ -0,0 +1,206 @@
+<?php
+
+namespace Mpociot\ApiDoc\Commands;
+
+use Illuminate\Console\Command;
+use Illuminate\Routing\Route;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\URL;
+use Mpociot\ApiDoc\Extracting\Generator;
+use Mpociot\ApiDoc\Matching\RouteMatcher\Match;
+use Mpociot\ApiDoc\Matching\RouteMatcherInterface;
+use Mpociot\ApiDoc\Tools\DocumentationConfig;
+use Mpociot\ApiDoc\Tools\Flags;
+use Mpociot\ApiDoc\Tools\Utils;
+use Mpociot\ApiDoc\Writing\Writer;
+use Mpociot\Reflection\DocBlock;
+use ReflectionClass;
+use ReflectionException;
+
+class GenerateDocumentation extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'apidoc:generate
+                            {--force : Force rewriting of existing routes}
+    ';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Generate your API documentation from existing Laravel routes.';
+
+    /**
+     * @var DocumentationConfig
+     */
+    private $docConfig;
+
+    /**
+     * @var string
+     */
+    private $baseUrl;
+
+    /**
+     * Execute the console command.
+     *
+     * @param RouteMatcherInterface $routeMatcher
+     *
+     * @return void
+     */
+    public function handle(RouteMatcherInterface $routeMatcher)
+    {
+        // Using a global static variable here, so fuck off if you don't like it.
+        // Also, the --verbose option is included with all Artisan commands.
+        Flags::$shouldBeVerbose = $this->option('verbose');
+
+        $this->docConfig = new DocumentationConfig(config('apidoc'));
+        $this->baseUrl = $this->docConfig->get('base_url') ?? config('app.url');
+
+        URL::forceRootUrl($this->baseUrl);
+
+        $routes = $routeMatcher->getRoutes($this->docConfig->get('routes'), $this->docConfig->get('router'));
+
+        $generator = new Generator($this->docConfig);
+        $parsedRoutes = $this->processRoutes($generator, $routes);
+
+        $groupedRoutes = collect($parsedRoutes)
+            ->groupBy('metadata.groupName')
+            ->sortBy(static function ($group) {
+                /* @var $group Collection */
+                return $group->first()['metadata']['groupName'];
+            }, SORT_NATURAL);
+        $writer = new Writer(
+            $this,
+            $this->docConfig,
+            $this->option('force')
+        );
+        $writer->writeDocs($groupedRoutes);
+    }
+
+    /**
+     * @param \Mpociot\ApiDoc\Extracting\Generator $generator
+     * @param Match[] $routes
+     *
+     * @throws \ReflectionException
+     *
+     * @return array
+     */
+    private function processRoutes(Generator $generator, array $routes)
+    {
+        $parsedRoutes = [];
+        foreach ($routes as $routeItem) {
+            $route = $routeItem->getRoute();
+            /** @var Route $route */
+            $messageFormat = '%s route: [%s] %s';
+            $routeMethods = implode(',', $generator->getMethods($route));
+            $routePath = $generator->getUri($route);
+
+            if ($this->isClosureRoute($route->getAction())) {
+                $this->warn(sprintf($messageFormat, 'Skipping', $routeMethods, $routePath) . ': Closure routes are not supported.');
+                continue;
+            }
+
+            $routeControllerAndMethod = Utils::getRouteClassAndMethodNames($route->getAction());
+            if (! $this->isValidRoute($routeControllerAndMethod)) {
+                $this->warn(sprintf($messageFormat, 'Skipping invalid', $routeMethods, $routePath));
+                continue;
+            }
+
+            if (! $this->doesControllerMethodExist($routeControllerAndMethod)) {
+                $this->warn(sprintf($messageFormat, 'Skipping', $routeMethods, $routePath) . ': Controller method does not exist.');
+                continue;
+            }
+
+            if (! $this->isRouteVisibleForDocumentation($routeControllerAndMethod)) {
+                $this->warn(sprintf($messageFormat, 'Skipping', $routeMethods, $routePath) . ': @hideFromAPIDocumentation was specified.');
+                continue;
+            }
+
+            try {
+                $parsedRoutes[] = $generator->processRoute($route, $routeItem->getRules());
+                $this->info(sprintf($messageFormat, 'Processed', $routeMethods, $routePath));
+            } catch (\Exception $exception) {
+                $this->warn(sprintf($messageFormat, 'Skipping', $routeMethods, $routePath) . '- Exception ' . get_class($exception) . ' encountered : ' . $exception->getMessage());
+            }
+        }
+
+        return $parsedRoutes;
+    }
+
+    /**
+     * @param array $routeControllerAndMethod
+     *
+     * @return bool
+     */
+    private function isValidRoute(array $routeControllerAndMethod = null)
+    {
+        if (is_array($routeControllerAndMethod)) {
+            $routeControllerAndMethod = implode('@', $routeControllerAndMethod);
+        }
+
+        return ! is_callable($routeControllerAndMethod) && ! is_null($routeControllerAndMethod);
+    }
+
+    /**
+     * @param array $routeAction
+     *
+     * @return bool
+     */
+    private function isClosureRoute(array $routeAction)
+    {
+        return $routeAction['uses'] instanceof \Closure;
+    }
+
+    /**
+     * @param array $routeControllerAndMethod
+     *
+     * @throws ReflectionException
+     *
+     * @return bool
+     */
+    private function doesControllerMethodExist(array $routeControllerAndMethod)
+    {
+        [$class, $method] = $routeControllerAndMethod;
+        $reflection = new ReflectionClass($class);
+
+        if (! $reflection->hasMethod($method)) {
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * @param array $routeControllerAndMethod
+     *
+     * @throws ReflectionException
+     *
+     * @return bool
+     */
+    private function isRouteVisibleForDocumentation(array $routeControllerAndMethod)
+    {
+        [$class, $method] = $routeControllerAndMethod;
+        $reflection = new ReflectionClass($class);
+
+        $tags = collect();
+
+        foreach (
+            array_filter([
+                $reflection->getDocComment(),
+                $reflection->getMethod($method)->getDocComment()
+            ]) as $comment
+        ) {
+            $phpdoc = new DocBlock($comment);
+            $tags = $tags->concat($phpdoc->getTags());
+        }
+
+        return $tags->filter(function ($tag) {
+            return $tag->getName() === 'hideFromAPIDocumentation';
+        })->isEmpty();
+    }
+}
diff --git a/src/Commands/RebuildDocumentation.php b/src/Commands/RebuildDocumentation.php
new file mode 100644
index 00000000..d1f48072
--- /dev/null
+++ b/src/Commands/RebuildDocumentation.php
@@ -0,0 +1,29 @@
+<?php
+
+namespace Mpociot\ApiDoc\Commands;
+
+use Illuminate\Console\Command;
+use Mpociot\ApiDoc\Tools\DocumentationConfig;
+use Mpociot\ApiDoc\Writing\Writer;
+
+class RebuildDocumentation extends Command
+{
+    protected $signature = 'apidoc:rebuild';
+
+    protected $description = 'Rebuild your API documentation from your markdown file.';
+
+    public function handle()
+    {
+        $sourceOutputPath = 'resources/docs/source';
+        if (! is_dir($sourceOutputPath)) {
+            $this->error('There is no existing documentation available at ' . $sourceOutputPath . '.');
+
+            return false;
+        }
+
+        $this->info('Rebuilding API documentation from ' . $sourceOutputPath . '/index.md');
+
+        $writer = new Writer($this, new DocumentationConfig(config('apidoc')));
+        $writer->writeHtmlDocs();
+    }
+}
diff --git a/src/Extracting/Generator.php b/src/Extracting/Generator.php
new file mode 100644
index 00000000..0a5f1df5
--- /dev/null
+++ b/src/Extracting/Generator.php
@@ -0,0 +1,244 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting;
+
+use Illuminate\Routing\Route;
+use Illuminate\Support\Arr;
+use Illuminate\Support\Str;
+use Mpociot\ApiDoc\Tools\DocumentationConfig;
+use Mpociot\ApiDoc\Tools\Utils;
+use ReflectionClass;
+use ReflectionMethod;
+
+class Generator
+{
+    /**
+     * @var DocumentationConfig
+     */
+    private $config;
+
+    public function __construct(DocumentationConfig $config = null)
+    {
+        // If no config is injected, pull from global
+        $this->config = $config ?: new DocumentationConfig(config('apidoc'));
+    }
+
+    /**
+     * @param Route $route
+     *
+     * @return mixed
+     */
+    public function getUri(Route $route)
+    {
+        return $route->uri();
+    }
+
+    /**
+     * @param Route $route
+     *
+     * @return mixed
+     */
+    public function getMethods(Route $route)
+    {
+        return array_diff($route->methods(), ['HEAD']);
+    }
+
+    /**
+     * @param \Illuminate\Routing\Route $route
+     * @param array $routeRules Rules to apply when generating documentation for this route
+     *
+     * @throws \ReflectionException
+     *
+     * @return array
+     */
+    public function processRoute(Route $route, array $routeRules = [])
+    {
+        [$controllerName, $methodName] = Utils::getRouteClassAndMethodNames($route->getAction());
+        $controller = new ReflectionClass($controllerName);
+        $method = $controller->getMethod($methodName);
+
+        $parsedRoute = [
+            'id' => md5($this->getUri($route) . ':' . implode($this->getMethods($route))),
+            'methods' => $this->getMethods($route),
+            'uri' => $this->getUri($route),
+        ];
+        $metadata = $this->fetchMetadata($controller, $method, $route, $routeRules, $parsedRoute);
+        $parsedRoute['metadata'] = $metadata;
+
+        $urlParameters = $this->fetchUrlParameters($controller, $method, $route, $routeRules, $parsedRoute);
+        $parsedRoute['urlParameters'] = $urlParameters;
+        $parsedRoute['cleanUrlParameters'] = $this->cleanParams($urlParameters);
+        $parsedRoute['boundUri'] = Utils::getFullUrl($route, $parsedRoute['cleanUrlParameters']);
+
+        $queryParameters = $this->fetchQueryParameters($controller, $method, $route, $routeRules, $parsedRoute);
+        $parsedRoute['queryParameters'] = $queryParameters;
+        $parsedRoute['cleanQueryParameters'] = $this->cleanParams($queryParameters);
+
+        $headers = $this->fetchRequestHeaders($controller, $method, $route, $routeRules, $parsedRoute);
+        $parsedRoute['headers'] = $headers;
+
+        $bodyParameters = $this->fetchBodyParameters($controller, $method, $route, $routeRules, $parsedRoute);
+        $parsedRoute['bodyParameters'] = $bodyParameters;
+        $parsedRoute['cleanBodyParameters'] = $this->cleanParams($bodyParameters);
+
+        $responses = $this->fetchResponses($controller, $method, $route, $routeRules, $parsedRoute);
+        $parsedRoute['responses'] = $responses;
+        $parsedRoute['showresponse'] = ! empty($responses);
+
+        return $parsedRoute;
+    }
+
+    protected function fetchMetadata(ReflectionClass $controller, ReflectionMethod $method, Route $route, array $rulesToApply, array $context = [])
+    {
+        $context['metadata'] = [
+            'groupName' => $this->config->get('default_group', ''),
+            'groupDescription' => '',
+            'title' => '',
+            'description' => '',
+            'authenticated' => false,
+        ];
+
+        return $this->iterateThroughStrategies('metadata', $context, [$route, $controller, $method, $rulesToApply]);
+    }
+
+    protected function fetchUrlParameters(ReflectionClass $controller, ReflectionMethod $method, Route $route, array $rulesToApply, array $context = [])
+    {
+        return $this->iterateThroughStrategies('urlParameters', $context, [$route, $controller, $method, $rulesToApply]);
+    }
+
+    protected function fetchQueryParameters(ReflectionClass $controller, ReflectionMethod $method, Route $route, array $rulesToApply, array $context = [])
+    {
+        return $this->iterateThroughStrategies('queryParameters', $context, [$route, $controller, $method, $rulesToApply]);
+    }
+
+    protected function fetchBodyParameters(ReflectionClass $controller, ReflectionMethod $method, Route $route, array $rulesToApply, array $context = [])
+    {
+        return $this->iterateThroughStrategies('bodyParameters', $context, [$route, $controller, $method, $rulesToApply]);
+    }
+
+    protected function fetchResponses(ReflectionClass $controller, ReflectionMethod $method, Route $route, array $rulesToApply, array $context = [])
+    {
+        $responses = $this->iterateThroughStrategies('responses', $context, [$route, $controller, $method, $rulesToApply]);
+        if (count($responses)) {
+            return array_filter($responses, function ($response) {
+                return $response['content'] != null;
+            });
+        }
+
+        return [];
+    }
+
+    protected function fetchRequestHeaders(ReflectionClass $controller, ReflectionMethod $method, Route $route, array $rulesToApply, array $context = [])
+    {
+        $headers = $this->iterateThroughStrategies('headers', $context, [$route, $controller, $method, $rulesToApply]);
+
+        return array_filter($headers);
+    }
+
+    protected function iterateThroughStrategies(string $stage, array $context, array $arguments)
+    {
+        $defaultStrategies = [
+            'metadata' => [
+                \Mpociot\ApiDoc\Extracting\Strategies\Metadata\GetFromDocBlocks::class,
+            ],
+            'urlParameters' => [
+                \Mpociot\ApiDoc\Extracting\Strategies\UrlParameters\GetFromUrlParamTag::class,
+            ],
+            'queryParameters' => [
+                \Mpociot\ApiDoc\Extracting\Strategies\QueryParameters\GetFromQueryParamTag::class,
+            ],
+            'headers' => [
+                \Mpociot\ApiDoc\Extracting\Strategies\RequestHeaders\GetFromRouteRules::class,
+            ],
+            'bodyParameters' => [
+                \Mpociot\ApiDoc\Extracting\Strategies\BodyParameters\GetFromBodyParamTag::class,
+            ],
+            'responses' => [
+                \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseTransformerTags::class,
+                \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseResponseTag::class,
+                \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseResponseFileTag::class,
+                \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseApiResourceTags::class,
+                \Mpociot\ApiDoc\Extracting\Strategies\Responses\ResponseCalls::class,
+            ],
+        ];
+
+        // Use the default strategies for the stage, unless they were explicitly set
+        $strategies = $this->config->get("strategies.$stage", $defaultStrategies[$stage]);
+        $context[$stage] = $context[$stage] ?? [];
+        foreach ($strategies as $strategyClass) {
+            $strategy = new $strategyClass($stage, $this->config);
+            $strategyArgs = $arguments;
+            $strategyArgs[] = $context;
+            $results = $strategy(...$strategyArgs);
+            if (! is_null($results)) {
+                foreach ($results as $index => $item) {
+                    if ($stage == 'responses') {
+                        // Responses are additive
+                        $context[$stage][] = $item;
+                        continue;
+                    }
+                    // Using a for loop rather than array_merge or +=
+                    // so it does not renumber numeric keys
+                    // and also allows values to be overwritten
+
+                    // Don't allow overwriting if an empty value is trying to replace a set one
+                    if (! in_array($context[$stage], [null, ''], true) && in_array($item, [null, ''], true)) {
+                        continue;
+                    } else {
+                        $context[$stage][$index] = $item;
+                    }
+                }
+            }
+        }
+
+        return $context[$stage];
+    }
+
+    /**
+     * Create samples at index 0 for array parameters.
+     * Also filter out parameters which were excluded from having examples.
+     *
+     * @param array $params
+     *
+     * @return array
+     */
+    protected function cleanParams(array $params)
+    {
+        $values = [];
+
+        // Remove params which have no examples.
+        $params = array_filter($params, function ($details) {
+            return ! is_null($details['value']);
+        });
+
+        foreach ($params as $paramName => $details) {
+            $this->generateConcreteSampleForArrayKeys(
+                $paramName,
+                $details['value'],
+                $values
+            );
+        }
+
+        return $values;
+    }
+
+    /**
+     * For each array notation parameter (eg user.*, item.*.name, object.*.*, user[])
+     * generate concrete sample (user.0, item.0.name, object.0.0, user.0) with example as value.
+     *
+     * @param string $paramName
+     * @param mixed $paramExample
+     * @param array $values The array that holds the result
+     *
+     * @return void
+     */
+    protected function generateConcreteSampleForArrayKeys($paramName, $paramExample, array &$values = [])
+    {
+        if (Str::contains($paramName, '[')) {
+            // Replace usages of [] with dot notation
+            $paramName = str_replace(['][', '[', ']', '..'], ['.', '.', '', '.*.'], $paramName);
+        }
+        // Then generate a sample item for the dot notation
+        Arr::set($values, str_replace(['.*', '*.'], ['.0','0.'], $paramName), $paramExample);
+    }
+}
diff --git a/src/Extracting/ParamHelpers.php b/src/Extracting/ParamHelpers.php
new file mode 100644
index 00000000..7bfaeac8
--- /dev/null
+++ b/src/Extracting/ParamHelpers.php
@@ -0,0 +1,131 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting;
+
+use Faker\Factory;
+use stdClass;
+
+trait ParamHelpers
+{
+    protected function generateDummyValue(string $type)
+    {
+        $faker = Factory::create();
+        if ($this->config->get('faker_seed')) {
+            $faker->seed($this->config->get('faker_seed'));
+        }
+        $fakeFactories = [
+            'integer' => function () use ($faker) {
+                return $faker->numberBetween(1, 20);
+            },
+            'number' => function () use ($faker) {
+                return $faker->randomFloat();
+            },
+            'float' => function () use ($faker) {
+                return $faker->randomFloat();
+            },
+            'boolean' => function () use ($faker) {
+                return $faker->boolean();
+            },
+            'string' => function () use ($faker) {
+                return $faker->word;
+            },
+            'array' => function () {
+                return [];
+            },
+            'object' => function () {
+                return new stdClass();
+            },
+        ];
+
+        $fakeFactory = $fakeFactories[$type] ?? $fakeFactories['string'];
+
+        return $fakeFactory();
+    }
+
+    /**
+     * Cast a value from a string to a specified type.
+     *
+     * @param string $value
+     * @param string $type
+     *
+     * @return mixed
+     */
+    protected function castToType(string $value, string $type)
+    {
+        $casts = [
+            'integer' => 'intval',
+            'int' => 'intval',
+            'float' => 'floatval',
+            'number' => 'floatval',
+            'double' => 'floatval',
+            'boolean' => 'boolval',
+            'bool' => 'boolval',
+        ];
+
+        // First, we handle booleans. We can't use a regular cast,
+        //because PHP considers string 'false' as true.
+        if ($value == 'false' && ($type == 'boolean' || $type == 'bool')) {
+            return false;
+        }
+
+        if (isset($casts[$type])) {
+            return $casts[$type]($value);
+        }
+
+        return $value;
+    }
+
+    /**
+     * Normalizes the stated "type" of a parameter (eg "int", "integer", "double")
+     * to a number of standard types (integer, boolean, float).
+     *
+     * @param string $type
+     *
+     * @return mixed|string
+     */
+    protected function normalizeParameterType(string $type)
+    {
+        $typeMap = [
+            'int' => 'integer',
+            'bool' => 'boolean',
+            'double' => 'float',
+        ];
+
+        return $type ? ($typeMap[$type] ?? $type) : 'string';
+    }
+
+    /**
+     * Allows users to specify that we shouldn't generate an example for the parameter
+     * by writing 'No-example'.
+     *
+     * @param string $description
+     *
+     * @return bool If true, don't generate an example for this.
+     */
+    protected function shouldExcludeExample(string $description)
+    {
+        return strpos($description, ' No-example') !== false;
+    }
+
+    /**
+     * Allows users to specify an example for the parameter by writing 'Example: the-example',
+     * to be used in example requests and response calls.
+     *
+     * @param string $description
+     * @param string $type The type of the parameter. Used to cast the example provided, if any.
+     *
+     * @return array The description and included example.
+     */
+    protected function parseParamDescription(string $description, string $type)
+    {
+        $example = null;
+        if (preg_match('/(.*)\bExample:\s*(.+)\s*/', $description, $content)) {
+            $description = trim($content[1]);
+
+            // examples are parsed as strings by default, we need to cast them properly
+            $example = $this->castToType($content[2], $type);
+        }
+
+        return [$description, $example];
+    }
+}
diff --git a/src/Extracting/RouteDocBlocker.php b/src/Extracting/RouteDocBlocker.php
new file mode 100644
index 00000000..cff9c336
--- /dev/null
+++ b/src/Extracting/RouteDocBlocker.php
@@ -0,0 +1,71 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting;
+
+use Illuminate\Routing\Route;
+use Mpociot\ApiDoc\Tools\Utils;
+use Mpociot\Reflection\DocBlock;
+use ReflectionClass;
+
+/**
+ * Class RouteDocBlocker
+ * Utility class to help with retrieving doc blocks from route classes and methods.
+ * Also caches them so repeated access is faster.
+ */
+class RouteDocBlocker
+{
+    protected static $docBlocks = [];
+
+    /**
+     * @param Route $route
+     *
+     * @throws \ReflectionException
+     * @throws \Exception
+     *
+     * @return array<string, DocBlock> Method and class docblocks
+     */
+    public static function getDocBlocksFromRoute(Route $route): array
+    {
+        list($className, $methodName) = Utils::getRouteClassAndMethodNames($route);
+        $docBlocks = self::getCachedDocBlock($route, $className, $methodName);
+        if ($docBlocks) {
+            return $docBlocks;
+        }
+
+        $class = new ReflectionClass($className);
+
+        if (! $class->hasMethod($methodName)) {
+            throw new \Exception("Error while fetching docblock for route: Class $className does not contain method $methodName");
+        }
+
+        $docBlocks = [
+            'method' => new DocBlock($class->getMethod($methodName)->getDocComment() ?: ''),
+            'class' => new DocBlock($class->getDocComment() ?: ''),
+        ];
+        self::cacheDocBlocks($route, $className, $methodName, $docBlocks);
+
+        return $docBlocks;
+    }
+
+    protected static function getCachedDocBlock(Route $route, string $className, string $methodName)
+    {
+        $routeId = self::getRouteCacheId($route, $className, $methodName);
+
+        return self::$docBlocks[$routeId] ?? null;
+    }
+
+    protected static function cacheDocBlocks(Route $route, string $className, string $methodName, array $docBlocks)
+    {
+        $routeId = self::getRouteCacheId($route, $className, $methodName);
+        self::$docBlocks[$routeId] = $docBlocks;
+    }
+
+    private static function getRouteCacheId(Route $route, string $className, string $methodName): string
+    {
+        return $route->uri()
+            . ':'
+            . implode(array_diff($route->methods(), ['HEAD']))
+            . $className
+            . $methodName;
+    }
+}
diff --git a/src/Extracting/Strategies/BodyParameters/GetFromBodyParamTag.php b/src/Extracting/Strategies/BodyParameters/GetFromBodyParamTag.php
new file mode 100644
index 00000000..204bb0c7
--- /dev/null
+++ b/src/Extracting/Strategies/BodyParameters/GetFromBodyParamTag.php
@@ -0,0 +1,94 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting\Strategies\BodyParameters;
+
+use Dingo\Api\Http\FormRequest as DingoFormRequest;
+use Illuminate\Foundation\Http\FormRequest as LaravelFormRequest;
+use Illuminate\Routing\Route;
+use Mpociot\ApiDoc\Extracting\ParamHelpers;
+use Mpociot\ApiDoc\Extracting\RouteDocBlocker;
+use Mpociot\ApiDoc\Extracting\Strategies\Strategy;
+use Mpociot\Reflection\DocBlock;
+use Mpociot\Reflection\DocBlock\Tag;
+use ReflectionClass;
+use ReflectionMethod;
+
+class GetFromBodyParamTag extends Strategy
+{
+    use ParamHelpers;
+
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        foreach ($method->getParameters() as $param) {
+            $paramType = $param->getType();
+            if ($paramType === null) {
+                continue;
+            }
+
+            $parameterClassName = $paramType->getName();
+
+            try {
+                $parameterClass = new ReflectionClass($parameterClassName);
+            } catch (\ReflectionException $e) {
+                continue;
+            }
+
+            // If there's a FormRequest, we check there for @bodyParam tags.
+            if (class_exists(LaravelFormRequest::class) && $parameterClass->isSubclassOf(LaravelFormRequest::class)
+                || class_exists(DingoFormRequest::class) && $parameterClass->isSubclassOf(DingoFormRequest::class)) {
+                $formRequestDocBlock = new DocBlock($parameterClass->getDocComment());
+                $bodyParametersFromDocBlock = $this->getBodyParametersFromDocBlock($formRequestDocBlock->getTags());
+
+                if (count($bodyParametersFromDocBlock)) {
+                    return $bodyParametersFromDocBlock;
+                }
+            }
+        }
+
+        /** @var DocBlock $methodDocBlock */
+        $methodDocBlock = RouteDocBlocker::getDocBlocksFromRoute($route)['method'];
+
+        return $this->getBodyParametersFromDocBlock($methodDocBlock->getTags());
+    }
+
+    private function getBodyParametersFromDocBlock($tags)
+    {
+        $parameters = collect($tags)
+            ->filter(function ($tag) {
+                return $tag instanceof Tag && $tag->getName() === 'bodyParam';
+            })
+            ->mapWithKeys(function (Tag $tag) {
+                // Format:
+                // @bodyParam <name> <type> <"required" (optional)> <description>
+                // Examples:
+                // @bodyParam text string required The text.
+                // @bodyParam user_id integer The ID of the user.
+                preg_match('/(.+?)\s+(.+?)\s+(required\s+)?(.*)/', $tag->getContent(), $content);
+                $content = preg_replace('/\s?No-example.?/', '', $content);
+                if (empty($content)) {
+                    // this means only name and type were supplied
+                    list($name, $type) = preg_split('/\s+/', $tag->getContent());
+                    $required = false;
+                    $description = '';
+                } else {
+                    list($_, $name, $type, $required, $description) = $content;
+                    $description = trim($description);
+                    if ($description == 'required' && empty(trim($required))) {
+                        $required = $description;
+                        $description = '';
+                    }
+                    $required = trim($required) == 'required' ? true : false;
+                }
+
+                $type = $this->normalizeParameterType($type);
+                list($description, $example) = $this->parseParamDescription($description, $type);
+                $value = is_null($example) && ! $this->shouldExcludeExample($tag->getContent())
+                    ? $this->generateDummyValue($type)
+                    : $example;
+
+                return [$name => compact('type', 'description', 'required', 'value')];
+            })->toArray();
+
+        return $parameters;
+    }
+}
diff --git a/src/Extracting/Strategies/Metadata/GetFromDocBlocks.php b/src/Extracting/Strategies/Metadata/GetFromDocBlocks.php
new file mode 100644
index 00000000..5edeec32
--- /dev/null
+++ b/src/Extracting/Strategies/Metadata/GetFromDocBlocks.php
@@ -0,0 +1,101 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting\Strategies\Metadata;
+
+use Illuminate\Routing\Route;
+use Mpociot\ApiDoc\Extracting\RouteDocBlocker;
+use Mpociot\ApiDoc\Extracting\Strategies\Strategy;
+use Mpociot\Reflection\DocBlock;
+use Mpociot\Reflection\DocBlock\Tag;
+use ReflectionClass;
+use ReflectionMethod;
+
+class GetFromDocBlocks extends Strategy
+{
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        $docBlocks = RouteDocBlocker::getDocBlocksFromRoute($route);
+        /** @var DocBlock $methodDocBlock */
+        $methodDocBlock = $docBlocks['method'];
+        $classDocBlock = $docBlocks['class'];
+
+        list($routeGroupName, $routeGroupDescription, $routeTitle) = $this->getRouteGroupDescriptionAndTitle($methodDocBlock, $classDocBlock);
+
+        return [
+            'groupName' => $routeGroupName,
+            'groupDescription' => $routeGroupDescription,
+            'title' => $routeTitle ?: $methodDocBlock->getShortDescription(),
+            'description' => $methodDocBlock->getLongDescription()->getContents(),
+            'authenticated' => $this->getAuthStatusFromDocBlock($classDocBlock->getTags()) ?: $this->getAuthStatusFromDocBlock($methodDocBlock->getTags()),
+        ];
+    }
+
+    /**
+     * @param array $tags Tags in the method doc block
+     *
+     * @return bool
+     */
+    protected function getAuthStatusFromDocBlock(array $tags)
+    {
+        $authTag = collect($tags)
+            ->first(function ($tag) {
+                return $tag instanceof Tag && strtolower($tag->getName()) === 'authenticated';
+            });
+
+        return (bool) $authTag;
+    }
+
+    /**
+     * @param DocBlock $methodDocBlock
+     * @param DocBlock $controllerDocBlock
+     *
+     * @return array The route group name, the group description, and the route title
+     */
+    protected function getRouteGroupDescriptionAndTitle(DocBlock $methodDocBlock, DocBlock $controllerDocBlock)
+    {
+        // @group tag on the method overrides that on the controller
+        if (! empty($methodDocBlock->getTags())) {
+            foreach ($methodDocBlock->getTags() as $tag) {
+                if ($tag->getName() === 'group') {
+                    $routeGroupParts = explode("\n", trim($tag->getContent()));
+                    $routeGroupName = array_shift($routeGroupParts);
+                    $routeGroupDescription = trim(implode("\n", $routeGroupParts));
+
+                    // If the route has no title (the methodDocBlock's "short description"),
+                    // we'll assume the routeGroupDescription is actually the title
+                    // Something like this:
+                    // /**
+                    //   * Fetch cars. <-- This is route title.
+                    //   * @group Cars <-- This is group name.
+                    //   * APIs for cars. <-- This is group description (not required).
+                    //   **/
+                    // VS
+                    // /**
+                    //   * @group Cars <-- This is group name.
+                    //   * Fetch cars. <-- This is route title, NOT group description.
+                    //   **/
+
+                    // BTW, this is a spaghetti way of doing this.
+                    // It shall be refactored soon. Deus vult!💪
+                    if (empty($methodDocBlock->getShortDescription())) {
+                        return [$routeGroupName, '', $routeGroupDescription];
+                    }
+
+                    return [$routeGroupName, $routeGroupDescription, $methodDocBlock->getShortDescription()];
+                }
+            }
+        }
+
+        foreach ($controllerDocBlock->getTags() as $tag) {
+            if ($tag->getName() === 'group') {
+                $routeGroupParts = explode("\n", trim($tag->getContent()));
+                $routeGroupName = array_shift($routeGroupParts);
+                $routeGroupDescription = implode("\n", $routeGroupParts);
+
+                return [$routeGroupName, $routeGroupDescription, $methodDocBlock->getShortDescription()];
+            }
+        }
+
+        return [$this->config->get('default_group'), '', $methodDocBlock->getShortDescription()];
+    }
+}
diff --git a/src/Extracting/Strategies/QueryParameters/GetFromQueryParamTag.php b/src/Extracting/Strategies/QueryParameters/GetFromQueryParamTag.php
new file mode 100644
index 00000000..b8c5e607
--- /dev/null
+++ b/src/Extracting/Strategies/QueryParameters/GetFromQueryParamTag.php
@@ -0,0 +1,96 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting\Strategies\QueryParameters;
+
+use Dingo\Api\Http\FormRequest as DingoFormRequest;
+use Illuminate\Foundation\Http\FormRequest as LaravelFormRequest;
+use Illuminate\Routing\Route;
+use Illuminate\Support\Str;
+use Mpociot\ApiDoc\Extracting\ParamHelpers;
+use Mpociot\ApiDoc\Extracting\RouteDocBlocker;
+use Mpociot\ApiDoc\Extracting\Strategies\Strategy;
+use Mpociot\Reflection\DocBlock;
+use Mpociot\Reflection\DocBlock\Tag;
+use ReflectionClass;
+use ReflectionMethod;
+
+class GetFromQueryParamTag extends Strategy
+{
+    use ParamHelpers;
+
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        foreach ($method->getParameters() as $param) {
+            $paramType = $param->getType();
+            if ($paramType === null) {
+                continue;
+            }
+
+            $parameterClassName = $paramType->getName();
+
+            try {
+                $parameterClass = new ReflectionClass($parameterClassName);
+            } catch (\ReflectionException $e) {
+                continue;
+            }
+
+            // If there's a FormRequest, we check there for @queryParam tags.
+            if (class_exists(LaravelFormRequest::class) && $parameterClass->isSubclassOf(LaravelFormRequest::class)
+                || class_exists(DingoFormRequest::class) && $parameterClass->isSubclassOf(DingoFormRequest::class)) {
+                $formRequestDocBlock = new DocBlock($parameterClass->getDocComment());
+                $queryParametersFromDocBlock = $this->getQueryParametersFromDocBlock($formRequestDocBlock->getTags());
+
+                if (count($queryParametersFromDocBlock)) {
+                    return $queryParametersFromDocBlock;
+                }
+            }
+        }
+
+        /** @var DocBlock $methodDocBlock */
+        $methodDocBlock = RouteDocBlocker::getDocBlocksFromRoute($route)['method'];
+
+        return $this->getQueryParametersFromDocBlock($methodDocBlock->getTags());
+    }
+
+    private function getQueryParametersFromDocBlock($tags)
+    {
+        $parameters = collect($tags)
+            ->filter(function ($tag) {
+                return $tag instanceof Tag && $tag->getName() === 'queryParam';
+            })
+            ->mapWithKeys(function (Tag $tag) {
+                // Format:
+                // @queryParam <name> <"required" (optional)> <description>
+                // Examples:
+                // @queryParam text string required The text.
+                // @queryParam user_id The ID of the user.
+                preg_match('/(.+?)\s+(required\s+)?(.*)/', $tag->getContent(), $content);
+                $content = preg_replace('/\s?No-example.?/', '', $content);
+                if (empty($content)) {
+                    // this means only name was supplied
+                    list($name) = preg_split('/\s+/', $tag->getContent());
+                    $required = false;
+                    $description = '';
+                } else {
+                    list($_, $name, $required, $description) = $content;
+                    $description = trim($description);
+                    if ($description == 'required' && empty(trim($required))) {
+                        $required = $description;
+                        $description = '';
+                    }
+                    $required = trim($required) == 'required' ? true : false;
+                }
+
+                list($description, $value) = $this->parseParamDescription($description, 'string');
+                if (is_null($value) && ! $this->shouldExcludeExample($tag->getContent())) {
+                    $value = Str::contains($description, ['number', 'count', 'page'])
+                        ? $this->generateDummyValue('integer')
+                        : $this->generateDummyValue('string');
+                }
+
+                return [$name => compact('description', 'required', 'value')];
+            })->toArray();
+
+        return $parameters;
+    }
+}
diff --git a/src/Extracting/Strategies/RequestHeaders/GetFromRouteRules.php b/src/Extracting/Strategies/RequestHeaders/GetFromRouteRules.php
new file mode 100644
index 00000000..3ac70cef
--- /dev/null
+++ b/src/Extracting/Strategies/RequestHeaders/GetFromRouteRules.php
@@ -0,0 +1,16 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting\Strategies\RequestHeaders;
+
+use Illuminate\Routing\Route;
+use Mpociot\ApiDoc\Extracting\Strategies\Strategy;
+use ReflectionClass;
+use ReflectionMethod;
+
+class GetFromRouteRules extends Strategy
+{
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        return $routeRules['headers'] ?? [];
+    }
+}
diff --git a/src/Extracting/Strategies/Responses/ResponseCalls.php b/src/Extracting/Strategies/Responses/ResponseCalls.php
new file mode 100644
index 00000000..6f419022
--- /dev/null
+++ b/src/Extracting/Strategies/Responses/ResponseCalls.php
@@ -0,0 +1,376 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting\Strategies\Responses;
+
+use Dingo\Api\Dispatcher;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\Routing\Route;
+use Illuminate\Support\Str;
+use Mpociot\ApiDoc\Extracting\ParamHelpers;
+use Mpociot\ApiDoc\Extracting\Strategies\Strategy;
+use Mpociot\ApiDoc\Tools\Flags;
+use Mpociot\ApiDoc\Tools\Utils;
+
+/**
+ * Make a call to the route and retrieve its response.
+ */
+class ResponseCalls extends Strategy
+{
+    use ParamHelpers;
+
+    /**
+     * @param Route $route
+     * @param \ReflectionClass $controller
+     * @param \ReflectionMethod $method
+     * @param array $routeRules
+     * @param array $context
+     *
+     * @return array|null
+     */
+    public function __invoke(Route $route, \ReflectionClass $controller, \ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        $rulesToApply = $routeRules['response_calls'] ?? [];
+        if (! $this->shouldMakeApiCall($route, $rulesToApply, $context)) {
+            return null;
+        }
+
+        $this->configureEnvironment($rulesToApply);
+
+        // Mix in parsed parameters with manually specified parameters.
+        $bodyParameters = array_merge($context['cleanBodyParameters'], $rulesToApply['bodyParams'] ?? []);
+        $queryParameters = array_merge($context['cleanQueryParameters'], $rulesToApply['queryParams'] ?? []);
+        $urlParameters = $context['cleanUrlParameters'];
+        $request = $this->prepareRequest($route, $rulesToApply, $urlParameters, $bodyParameters, $queryParameters, $context['headers'] ?? []);
+
+        try {
+            $response = $this->makeApiCall($request);
+            $response = [
+                [
+                    'status' => $response->getStatusCode(),
+                    'content' => $response->getContent(),
+                ],
+            ];
+        } catch (\Exception $e) {
+            echo 'Exception thrown during response call for [' . implode(',', $route->methods) . "] {$route->uri}.\n";
+            if (Flags::$shouldBeVerbose) {
+                Utils::dumpException($e);
+            } else {
+                echo "Run this again with the --verbose flag to see the exception.\n";
+            }
+            $response = null;
+        } finally {
+            $this->finish();
+        }
+
+        return $response;
+    }
+
+    /**
+     * @param array $rulesToApply
+     *
+     * @return void
+     */
+    private function configureEnvironment(array $rulesToApply)
+    {
+        $this->startDbTransaction();
+        $this->setEnvironmentVariables($rulesToApply['env'] ?? []);
+        $this->setLaravelConfigs($rulesToApply['config'] ?? []);
+    }
+
+    /**
+     * @param Route $route
+     * @param array $rulesToApply
+     * @param array $bodyParams
+     * @param array $queryParams
+     *
+     * @return Request
+     */
+    protected function prepareRequest(Route $route, array $rulesToApply, array $urlParams, array $bodyParams, array $queryParams, array $headers)
+    {
+        $uri = Utils::getFullUrl($route, $urlParams);
+        $routeMethods = $this->getMethods($route);
+        $method = array_shift($routeMethods);
+        $cookies = isset($rulesToApply['cookies']) ? $rulesToApply['cookies'] : [];
+
+        // Note that we initialise the request with the bodyPatams here
+        // and later still add them to the ParameterBag (`addBodyParameters`)
+        // The first is so the body params get added to the request content
+        // (where Laravel reads body from)
+        // The second is so they get added to the request bag
+        // (where Symfony usually reads from and Laravel sometimes does)
+        // Adding to both ensures consistency
+        $request = Request::create($uri, $method, [], $cookies, [], $this->transformHeadersToServerVars($headers), json_encode($bodyParams));
+        // Doing it again to catch any ones we didn't transform properly.
+        $request = $this->addHeaders($request, $route, $headers);
+
+        $request = $this->addQueryParameters($request, $queryParams);
+        $request = $this->addBodyParameters($request, $bodyParams);
+
+        return $request;
+    }
+
+    /**
+     * @param array $env
+     *
+     * @return void
+     *
+     * @deprecated Not guaranteed to overwrite application's env. Use Laravel config variables instead.
+     */
+    private function setEnvironmentVariables(array $env)
+    {
+        foreach ($env as $name => $value) {
+            putenv("$name=$value");
+
+            $_ENV[$name] = $value;
+            $_SERVER[$name] = $value;
+        }
+    }
+
+    /**
+     * @param array $config
+     *
+     * @return void
+     */
+    private function setLaravelConfigs(array $config)
+    {
+        if (empty($config)) {
+            return;
+        }
+
+        foreach ($config as $name => $value) {
+            config([$name => $value]);
+        }
+    }
+
+    /**
+     * @return void
+     */
+    private function startDbTransaction()
+    {
+        try {
+            app('db')->beginTransaction();
+        } catch (\Exception $e) {
+        }
+    }
+
+    /**
+     * @return void
+     */
+    private function endDbTransaction()
+    {
+        try {
+            app('db')->rollBack();
+        } catch (\Exception $e) {
+        }
+    }
+
+    /**
+     * @return void
+     */
+    private function finish()
+    {
+        $this->endDbTransaction();
+    }
+
+    /**
+     * @param Request $request
+     *
+     * @return \Illuminate\Http\JsonResponse|mixed
+     */
+    public function callDingoRoute(Request $request)
+    {
+        /** @var Dispatcher $dispatcher */
+        $dispatcher = app(\Dingo\Api\Dispatcher::class);
+
+        foreach ($request->headers as $header => $value) {
+            $dispatcher->header($header, $value);
+        }
+
+        // set domain and body parameters
+        $dispatcher->on($request->header('SERVER_NAME'))
+            ->with($request->request->all());
+
+        // set URL and query parameters
+        $uri = $request->getRequestUri();
+        $query = $request->getQueryString();
+        if (! empty($query)) {
+            $uri .= "?$query";
+        }
+        $response = call_user_func_array([$dispatcher, strtolower($request->method())], [$uri]);
+
+        // the response from the Dingo dispatcher is the 'raw' response from the controller,
+        // so we have to ensure it's JSON first
+        if (! $response instanceof Response) {
+            $response = response()->json($response);
+        }
+
+        return $response;
+    }
+
+    /**
+     * @param Route $route
+     *
+     * @return array
+     */
+    public function getMethods(Route $route)
+    {
+        return array_diff($route->methods(), ['HEAD']);
+    }
+
+    /**
+     * @param Request $request
+     * @param Route $route
+     * @param array|null $headers
+     *
+     * @return Request
+     */
+    private function addHeaders(Request $request, Route $route, $headers)
+    {
+        // set the proper domain
+        if ($route->getDomain()) {
+            $request->headers->add([
+                'HOST' => $route->getDomain(),
+            ]);
+            $request->server->add([
+                'HTTP_HOST' => $route->getDomain(),
+                'SERVER_NAME' => $route->getDomain(),
+            ]);
+        }
+
+        $headers = collect($headers);
+
+        if (($headers->get('Accept') ?: $headers->get('accept')) === 'application/json') {
+            $request->setRequestFormat('json');
+        }
+
+        return $request;
+    }
+
+    /**
+     * @param Request $request
+     * @param array $query
+     *
+     * @return Request
+     */
+    private function addQueryParameters(Request $request, array $query)
+    {
+        $request->query->add($query);
+        $request->server->add(['QUERY_STRING' => http_build_query($query)]);
+
+        return $request;
+    }
+
+    /**
+     * @param Request $request
+     * @param array $body
+     *
+     * @return Request
+     */
+    private function addBodyParameters(Request $request, array $body)
+    {
+        $request->request->add($body);
+
+        return $request;
+    }
+
+    /**
+     * @param Request $request
+     *
+     * @throws \Exception
+     *
+     * @return \Illuminate\Http\JsonResponse|mixed|\Symfony\Component\HttpFoundation\Response
+     */
+    protected function makeApiCall(Request $request)
+    {
+        if (config('apidoc.router') == 'dingo') {
+            $response = $this->callDingoRoute($request);
+        } else {
+            $response = $this->callLaravelRoute($request);
+        }
+
+        return $response;
+    }
+
+    /**
+     * @param Request $request
+     *
+     * @throws \Exception
+     *
+     * @return \Symfony\Component\HttpFoundation\Response
+     */
+    protected function callLaravelRoute(Request $request): \Symfony\Component\HttpFoundation\Response
+    {
+        // Confirm we're running in Laravel, not Lumen
+        if (app()->bound(\Illuminate\Contracts\Http\Kernel::class)) {
+            $kernel = app(\Illuminate\Contracts\Http\Kernel::class);
+            $response = $kernel->handle($request);
+            $kernel->terminate($request, $response);
+        } else {
+            // Handle the request using the Lumen application.
+            $kernel = app();
+            $response = $kernel->handle($request);
+        }
+
+        return $response;
+    }
+
+    /**
+     * @param Route $route
+     * @param array $rulesToApply
+     *
+     * @return bool
+     */
+    protected function shouldMakeApiCall(Route $route, array $rulesToApply, array $context): bool
+    {
+        $allowedMethods = $rulesToApply['methods'] ?? [];
+        if (empty($allowedMethods)) {
+            return false;
+        }
+
+        // Don't attempt a response call if there are already successful responses
+        $successResponses = collect($context['responses'])->filter(function ($response) {
+            return ((string) $response['status'])[0] == '2';
+        })->count();
+        if ($successResponses) {
+            return false;
+        }
+
+        if (is_string($allowedMethods) && $allowedMethods == '*') {
+            return true;
+        }
+
+        if (array_search('*', $allowedMethods) !== false) {
+            return true;
+        }
+
+        $routeMethods = $this->getMethods($route);
+        if (in_array(array_shift($routeMethods), $allowedMethods)) {
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Transform headers array to array of $_SERVER vars with HTTP_* format.
+     *
+     * @param  array  $headers
+     *
+     * @return array
+     */
+    protected function transformHeadersToServerVars(array $headers)
+    {
+        $server = [];
+        $prefix = 'HTTP_';
+        foreach ($headers as $name => $value) {
+            $name = strtr(strtoupper($name), '-', '_');
+            if (! Str::startsWith($name, $prefix) && $name !== 'CONTENT_TYPE') {
+                $name = $prefix . $name;
+            }
+            $server[$name] = $value;
+        }
+
+        return $server;
+    }
+}
diff --git a/src/Extracting/Strategies/Responses/UseApiResourceTags.php b/src/Extracting/Strategies/Responses/UseApiResourceTags.php
new file mode 100644
index 00000000..f7fff206
--- /dev/null
+++ b/src/Extracting/Strategies/Responses/UseApiResourceTags.php
@@ -0,0 +1,194 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting\Strategies\Responses;
+
+use Exception;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+use Illuminate\Http\Resources\Json\ResourceCollection;
+use Illuminate\Http\Response;
+use Illuminate\Routing\Route;
+use Illuminate\Support\Arr;
+use League\Fractal\Resource\Collection;
+use Mpociot\ApiDoc\Extracting\RouteDocBlocker;
+use Mpociot\ApiDoc\Extracting\Strategies\Strategy;
+use Mpociot\ApiDoc\Tools\Flags;
+use Mpociot\ApiDoc\Tools\Utils;
+use Mpociot\Reflection\DocBlock;
+use Mpociot\Reflection\DocBlock\Tag;
+use ReflectionClass;
+use ReflectionMethod;
+
+/**
+ * Parse an Eloquent API resource response from the docblock ( @apiResource || @apiResourcecollection ).
+ */
+class UseApiResourceTags extends Strategy
+{
+    /**
+     * @param Route $route
+     * @param ReflectionClass $controller
+     * @param ReflectionMethod $method
+     * @param array $rulesToApply
+     * @param array $context
+     *
+     * @throws \Exception
+     *
+     * @return array|null
+     */
+    public function __invoke(Route $route, \ReflectionClass $controller, \ReflectionMethod $method, array $rulesToApply, array $context = [])
+    {
+        $docBlocks = RouteDocBlocker::getDocBlocksFromRoute($route);
+        /** @var DocBlock $methodDocBlock */
+        $methodDocBlock = $docBlocks['method'];
+
+        return $this->getApiResourceResponse($methodDocBlock->getTags(), $route);
+    }
+
+    /**
+     * Get a response from the transformer tags.
+     *
+     * @param array $tags
+     *
+     * @return array|null
+     */
+    protected function getApiResourceResponse(array $tags, Route $route)
+    {
+        try {
+            if (empty($apiResourceTag = $this->getApiResourceTag($tags))) {
+                return null;
+            }
+
+            list($statusCode, $apiResourceClass) = $this->getStatusCodeAndApiResourceClass($apiResourceTag);
+            $model = $this->getClassToBeTransformed($tags);
+            $modelInstance = $this->instantiateApiResourceModel($model);
+
+            try {
+                $resource = new $apiResourceClass($modelInstance);
+            } catch (\Exception $e) {
+                // If it is a ResourceCollection class, it might throw an error
+                // when trying to instantiate with something other than a collection
+                $resource = new $apiResourceClass(collect([$modelInstance]));
+            }
+            if (strtolower($apiResourceTag->getName()) == 'apiresourcecollection') {
+                // Collections can either use the regular JsonResource class (via `::collection()`,
+                // or a ResourceCollection (via `new`)
+                // See https://laravel.com/docs/5.8/eloquent-resources
+                $models = [$modelInstance, $this->instantiateApiResourceModel($model)];
+                $resource = $resource instanceof ResourceCollection
+                    ? new $apiResourceClass(collect($models))
+                    : $apiResourceClass::collection(collect($models));
+            }
+
+            /** @var Response $response */
+            $response = $resource->toResponse(app(Request::class));
+
+            return [
+                [
+                    'status' => $statusCode ?: $response->getStatusCode(),
+                    'content' => $response->getContent(),
+                ],
+            ];
+        } catch (\Exception $e) {
+            echo 'Exception thrown when fetching Eloquent API resource response for [' . implode(',', $route->methods) . "] {$route->uri}.\n";
+            if (Flags::$shouldBeVerbose) {
+                Utils::dumpException($e);
+            } else {
+                echo "Run this again with the --verbose flag to see the exception.\n";
+            }
+
+            return null;
+        }
+    }
+
+    /**
+     * @param Tag $tag
+     *
+     * @return array
+     */
+    private function getStatusCodeAndApiResourceClass($tag): array
+    {
+        $content = $tag->getContent();
+        preg_match('/^(\d{3})?\s?([\s\S]*)$/', $content, $result);
+        $status = $result[1] ?: 0;
+        $apiResourceClass = $result[2];
+
+        return [$status, $apiResourceClass];
+    }
+
+    /**
+     * @param array $tags
+     *
+     * @return string
+     */
+    private function getClassToBeTransformed(array $tags): string
+    {
+        $modelTag = Arr::first(array_filter($tags, function ($tag) {
+            return ($tag instanceof Tag) && strtolower($tag->getName()) == 'apiresourcemodel';
+        }));
+
+        $type = $modelTag->getContent();
+
+        if (empty($type)) {
+            throw new Exception('Failed to detect an Eloquent API resource model. Please specify a model using @apiResourceModel.');
+        }
+
+        return $type;
+    }
+
+    /**
+     * @param string $type
+     *
+     * @return Model|object
+     */
+    protected function instantiateApiResourceModel(string $type)
+    {
+        try {
+            // Try Eloquent model factory
+
+            // Factories are usually defined without the leading \ in the class name,
+            // but the user might write it that way in a comment. Let's be safe.
+            $type = ltrim($type, '\\');
+
+            return factory($type)->make();
+        } catch (\Exception $e) {
+            if (Flags::$shouldBeVerbose) {
+                echo "Eloquent model factory failed to instantiate {$type}; trying to fetch from database.\n";
+            }
+
+            $instance = new $type();
+            if ($instance instanceof \Illuminate\Database\Eloquent\Model) {
+                try {
+                    // we can't use a factory but can try to get one from the database
+                    $firstInstance = $type::first();
+                    if ($firstInstance) {
+                        return $firstInstance;
+                    }
+                } catch (\Exception $e) {
+                    // okay, we'll stick with `new`
+                    if (Flags::$shouldBeVerbose) {
+                        echo "Failed to fetch first {$type} from database; using `new` to instantiate.\n";
+                    }
+                }
+            }
+        }
+
+        return $instance;
+    }
+
+    /**
+     * @param array $tags
+     *
+     * @return Tag|null
+     */
+    private function getApiResourceTag(array $tags)
+    {
+        $apiResourceTags = array_values(
+            array_filter($tags, function ($tag) {
+                return ($tag instanceof Tag) && in_array(strtolower($tag->getName()), ['apiresource', 'apiresourcecollection']);
+            })
+        );
+
+        return Arr::first($apiResourceTags);
+    }
+}
diff --git a/src/Extracting/Strategies/Responses/UseResponseFileTag.php b/src/Extracting/Strategies/Responses/UseResponseFileTag.php
new file mode 100644
index 00000000..007f4fc1
--- /dev/null
+++ b/src/Extracting/Strategies/Responses/UseResponseFileTag.php
@@ -0,0 +1,73 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting\Strategies\Responses;
+
+use Illuminate\Routing\Route;
+use Mpociot\ApiDoc\Extracting\RouteDocBlocker;
+use Mpociot\ApiDoc\Extracting\Strategies\Strategy;
+use Mpociot\Reflection\DocBlock;
+use Mpociot\Reflection\DocBlock\Tag;
+
+/**
+ * Get a response from from a file in the docblock ( @responseFile ).
+ */
+class UseResponseFileTag extends Strategy
+{
+    /**
+     * @param Route $route
+     * @param \ReflectionClass $controller
+     * @param \ReflectionMethod $method
+     * @param array $routeRules
+     * @param array $context
+     *
+     * @throws \Exception If the response file does not exist
+     *
+     * @return array|null
+     */
+    public function __invoke(Route $route, \ReflectionClass $controller, \ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        $docBlocks = RouteDocBlocker::getDocBlocksFromRoute($route);
+        /** @var DocBlock $methodDocBlock */
+        $methodDocBlock = $docBlocks['method'];
+
+        return $this->getFileResponses($methodDocBlock->getTags());
+    }
+
+    /**
+     * Get the response from the file if available.
+     *
+     * @param array $tags
+     *
+     * @return array|null
+     */
+    protected function getFileResponses(array $tags)
+    {
+        // Avoid "holes" in the keys of the filtered array, by using array_values on the filtered array
+        $responseFileTags = array_values(
+            array_filter($tags, function ($tag) {
+                return $tag instanceof Tag && strtolower($tag->getName()) === 'responsefile';
+            })
+        );
+
+        if (empty($responseFileTags)) {
+            return null;
+        }
+
+        $responses = array_map(function (Tag $responseFileTag) {
+            preg_match('/^(\d{3})?\s?([\S]*[\s]*?)(\{.*\})?$/', $responseFileTag->getContent(), $result);
+            $relativeFilePath = trim($result[2]);
+            $filePath = storage_path($relativeFilePath);
+            if (! file_exists($filePath)) {
+                throw new \Exception('@responseFile ' . $relativeFilePath . ' does not exist');
+            }
+            $status = $result[1] ?: 200;
+            $content = $result[2] ? file_get_contents($filePath, true) : '{}';
+            $json = ! empty($result[3]) ? str_replace("'", '"', $result[3]) : '{}';
+            $merged = array_merge(json_decode($content, true), json_decode($json, true));
+
+            return ['content' => json_encode($merged), 'status' => (int) $status];
+        }, $responseFileTags);
+
+        return $responses;
+    }
+}
diff --git a/src/Extracting/Strategies/Responses/UseResponseTag.php b/src/Extracting/Strategies/Responses/UseResponseTag.php
new file mode 100644
index 00000000..7028a560
--- /dev/null
+++ b/src/Extracting/Strategies/Responses/UseResponseTag.php
@@ -0,0 +1,66 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting\Strategies\Responses;
+
+use Illuminate\Routing\Route;
+use Mpociot\ApiDoc\Extracting\RouteDocBlocker;
+use Mpociot\ApiDoc\Extracting\Strategies\Strategy;
+use Mpociot\Reflection\DocBlock;
+use Mpociot\Reflection\DocBlock\Tag;
+
+/**
+ * Get a response from the docblock ( @response ).
+ */
+class UseResponseTag extends Strategy
+{
+    /**
+     * @param Route $route
+     * @param \ReflectionClass $controller
+     * @param \ReflectionMethod $method
+     * @param array $routeRules
+     * @param array $context
+     *
+     * @throws \Exception
+     *
+     * @return array|null
+     */
+    public function __invoke(Route $route, \ReflectionClass $controller, \ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        $docBlocks = RouteDocBlocker::getDocBlocksFromRoute($route);
+        /** @var DocBlock $methodDocBlock */
+        $methodDocBlock = $docBlocks['method'];
+
+        return $this->getDocBlockResponses($methodDocBlock->getTags());
+    }
+
+    /**
+     * Get the response from the docblock if available.
+     *
+     * @param array $tags
+     *
+     * @return array|null
+     */
+    protected function getDocBlockResponses(array $tags)
+    {
+        $responseTags = array_values(
+            array_filter($tags, function ($tag) {
+                return $tag instanceof Tag && strtolower($tag->getName()) === 'response';
+            })
+        );
+
+        if (empty($responseTags)) {
+            return null;
+        }
+
+        $responses = array_map(function (Tag $responseTag) {
+            preg_match('/^(\d{3})?\s?([\s\S]*)$/', $responseTag->getContent(), $result);
+
+            $status = $result[1] ?: 200;
+            $content = $result[2] ?: '{}';
+
+            return ['content' => $content, 'status' => (int) $status];
+        }, $responseTags);
+
+        return $responses;
+    }
+}
diff --git a/src/Extracting/Strategies/Responses/UseTransformerTags.php b/src/Extracting/Strategies/Responses/UseTransformerTags.php
new file mode 100644
index 00000000..9c87b973
--- /dev/null
+++ b/src/Extracting/Strategies/Responses/UseTransformerTags.php
@@ -0,0 +1,201 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting\Strategies\Responses;
+
+use Exception;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Model as IlluminateModel;
+use Illuminate\Routing\Route;
+use Illuminate\Support\Arr;
+use League\Fractal\Manager;
+use League\Fractal\Resource\Collection;
+use League\Fractal\Resource\Item;
+use Mpociot\ApiDoc\Extracting\RouteDocBlocker;
+use Mpociot\ApiDoc\Extracting\Strategies\Strategy;
+use Mpociot\ApiDoc\Tools\Flags;
+use Mpociot\ApiDoc\Tools\Utils;
+use Mpociot\Reflection\DocBlock;
+use Mpociot\Reflection\DocBlock\Tag;
+use ReflectionClass;
+use ReflectionMethod;
+
+/**
+ * Parse a transformer response from the docblock ( @transformer || @transformercollection ).
+ */
+class UseTransformerTags extends Strategy
+{
+    /**
+     * @param Route $route
+     * @param ReflectionClass $controller
+     * @param ReflectionMethod $method
+     * @param array $rulesToApply
+     * @param array $context
+     *
+     * @throws \Exception
+     *
+     * @return array|null
+     */
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $rulesToApply, array $context = [])
+    {
+        $docBlocks = RouteDocBlocker::getDocBlocksFromRoute($route);
+        /** @var DocBlock $methodDocBlock */
+        $methodDocBlock = $docBlocks['method'];
+
+        return $this->getTransformerResponse($methodDocBlock->getTags(), $route);
+    }
+
+    /**
+     * Get a response from the transformer tags.
+     *
+     * @param array $tags
+     * @param Route $route
+     *
+     * @return array|null
+     */
+    protected function getTransformerResponse(array $tags, Route $route)
+    {
+        try {
+            if (empty($transformerTag = $this->getTransformerTag($tags))) {
+                return null;
+            }
+
+            [$statusCode, $transformer] = $this->getStatusCodeAndTransformerClass($transformerTag);
+            $model = $this->getClassToBeTransformed($tags, (new ReflectionClass($transformer))->getMethod('transform'));
+            $modelInstance = $this->instantiateTransformerModel($model);
+
+            $fractal = new Manager();
+
+            if (! is_null(config('apidoc.fractal.serializer'))) {
+                $fractal->setSerializer(app(config('apidoc.fractal.serializer')));
+            }
+
+            $resource = (strtolower($transformerTag->getName()) == 'transformercollection')
+                ? new Collection(
+                    [$modelInstance, $this->instantiateTransformerModel($model)],
+                    new $transformer()
+                )
+                : new Item($modelInstance, new $transformer());
+
+            $response = response($fractal->createData($resource)->toJson());
+
+            return [
+                [
+                    'status' => $statusCode ?: $response->getStatusCode(),
+                    'content' => $response->getContent(),
+                ],
+            ];
+        } catch (Exception $e) {
+            echo 'Exception thrown when fetching transformer response for [' . implode(',', $route->methods) . "] {$route->uri}.\n";
+            if (Flags::$shouldBeVerbose) {
+                Utils::dumpException($e);
+            } else {
+                echo "Run this again with the --verbose flag to see the exception.\n";
+            }
+
+            return null;
+        }
+    }
+
+    /**
+     * @param Tag $tag
+     *
+     * @return array
+     */
+    private function getStatusCodeAndTransformerClass($tag): array
+    {
+        $content = $tag->getContent();
+        preg_match('/^(\d{3})?\s?([\s\S]*)$/', $content, $result);
+        $status = $result[1] ?: 200;
+        $transformerClass = $result[2];
+
+        return [$status, $transformerClass];
+    }
+
+    /**
+     * @param array $tags
+     * @param ReflectionMethod $transformerMethod
+     *
+     * @throws Exception
+     *
+     * @return string
+     */
+    private function getClassToBeTransformed(array $tags, ReflectionMethod $transformerMethod): string
+    {
+        $modelTag = Arr::first(array_filter($tags, function ($tag) {
+            return ($tag instanceof Tag) && strtolower($tag->getName()) == 'transformermodel';
+        }));
+
+        $type = null;
+        if ($modelTag) {
+            $type = $modelTag->getContent();
+        } else {
+            $parameter = Arr::first($transformerMethod->getParameters());
+            if ($parameter->hasType() && ! $parameter->getType()->isBuiltin() && class_exists($parameter->getType()->getName())) {
+                // Ladies and gentlemen, we have a type!
+                $type = $parameter->getType()->getName();
+            }
+        }
+
+        if ($type == null) {
+            throw new Exception('Failed to detect a transformer model. Please specify a model using @transformerModel.');
+        }
+
+        return $type;
+    }
+
+    /**
+     * @param string $type
+     *
+     * @return Model|object
+     */
+    protected function instantiateTransformerModel(string $type)
+    {
+        try {
+            // try Eloquent model factory
+
+            // Factories are usually defined without the leading \ in the class name,
+            // but the user might write it that way in a comment. Let's be safe.
+            $type = ltrim($type, '\\');
+
+            return factory($type)->make();
+        } catch (Exception $e) {
+            if (Flags::$shouldBeVerbose) {
+                echo "Eloquent model factory failed to instantiate {$type}; trying to fetch from database.\n";
+            }
+
+            $instance = new $type();
+            if ($instance instanceof IlluminateModel) {
+                try {
+                    // we can't use a factory but can try to get one from the database
+                    $firstInstance = $type::first();
+                    if ($firstInstance) {
+                        return $firstInstance;
+                    }
+                } catch (Exception $e) {
+                    // okay, we'll stick with `new`
+                    if (Flags::$shouldBeVerbose) {
+                        echo "Failed to fetch first {$type} from database; using `new` to instantiate.\n";
+                    }
+                }
+            }
+        }
+
+        return $instance;
+    }
+
+    /**
+     * @param array $tags
+     *
+     * @return Tag|null
+     */
+    private function getTransformerTag(array $tags)
+    {
+        $transformerTags = array_values(
+            array_filter($tags, function ($tag) {
+                return ($tag instanceof Tag) && in_array(strtolower($tag->getName()), ['transformer', 'transformercollection']);
+            })
+        );
+
+        return Arr::first($transformerTags);
+    }
+}
diff --git a/src/Extracting/Strategies/Strategy.php b/src/Extracting/Strategies/Strategy.php
new file mode 100644
index 00000000..19b7cc94
--- /dev/null
+++ b/src/Extracting/Strategies/Strategy.php
@@ -0,0 +1,40 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting\Strategies;
+
+use Illuminate\Routing\Route;
+use Mpociot\ApiDoc\Tools\DocumentationConfig;
+use ReflectionClass;
+use ReflectionMethod;
+
+abstract class Strategy
+{
+    /**
+     * @var DocumentationConfig The apidoc config
+     */
+    protected $config;
+
+    /**
+     * @var string The current stage of route processing
+     */
+    protected $stage;
+
+    public function __construct(string $stage, DocumentationConfig $config)
+    {
+        $this->stage = $stage;
+        $this->config = $config;
+    }
+
+    /**
+     * @param Route $route
+     * @param ReflectionClass $controller
+     * @param ReflectionMethod $method
+     * @param array $routeRules Array of rules for the ruleset which this route belongs to.
+     * @param array $context Results from the previous stages
+     *
+     * @throws \Exception
+     *
+     * @return array|null
+     */
+    abstract public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = []);
+}
diff --git a/src/Extracting/Strategies/UrlParameters/GetFromUrlParamTag.php b/src/Extracting/Strategies/UrlParameters/GetFromUrlParamTag.php
new file mode 100644
index 00000000..a4ddb8e8
--- /dev/null
+++ b/src/Extracting/Strategies/UrlParameters/GetFromUrlParamTag.php
@@ -0,0 +1,96 @@
+<?php
+
+namespace Mpociot\ApiDoc\Extracting\Strategies\UrlParameters;
+
+use Dingo\Api\Http\FormRequest as DingoFormRequest;
+use Illuminate\Foundation\Http\FormRequest as LaravelFormRequest;
+use Illuminate\Routing\Route;
+use Illuminate\Support\Str;
+use Mpociot\ApiDoc\Extracting\ParamHelpers;
+use Mpociot\ApiDoc\Extracting\RouteDocBlocker;
+use Mpociot\ApiDoc\Extracting\Strategies\Strategy;
+use Mpociot\Reflection\DocBlock;
+use Mpociot\Reflection\DocBlock\Tag;
+use ReflectionClass;
+use ReflectionMethod;
+
+class GetFromUrlParamTag extends Strategy
+{
+    use ParamHelpers;
+
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        foreach ($method->getParameters() as $param) {
+            $paramType = $param->getType();
+            if ($paramType === null) {
+                continue;
+            }
+
+            $parameterClassName = $paramType->getName();
+
+            try {
+                $parameterClass = new ReflectionClass($parameterClassName);
+            } catch (\ReflectionException $e) {
+                continue;
+            }
+
+            // If there's a FormRequest, we check there for @urlParam tags.
+            if (class_exists(LaravelFormRequest::class) && $parameterClass->isSubclassOf(LaravelFormRequest::class)
+                || class_exists(DingoFormRequest::class) && $parameterClass->isSubclassOf(DingoFormRequest::class)) {
+                $formRequestDocBlock = new DocBlock($parameterClass->getDocComment());
+                $queryParametersFromDocBlock = $this->getUrlParametersFromDocBlock($formRequestDocBlock->getTags());
+
+                if (count($queryParametersFromDocBlock)) {
+                    return $queryParametersFromDocBlock;
+                }
+            }
+        }
+
+        /** @var DocBlock $methodDocBlock */
+        $methodDocBlock = RouteDocBlocker::getDocBlocksFromRoute($route)['method'];
+
+        return $this->getUrlParametersFromDocBlock($methodDocBlock->getTags());
+    }
+
+    private function getUrlParametersFromDocBlock($tags)
+    {
+        $parameters = collect($tags)
+            ->filter(function ($tag) {
+                return $tag instanceof Tag && $tag->getName() === 'urlParam';
+            })
+            ->mapWithKeys(function (Tag $tag) {
+                // Format:
+                // @urlParam <name> <"required" (optional)> <description>
+                // Examples:
+                // @urlParam id string required The id of the post.
+                // @urlParam user_id The ID of the user.
+                preg_match('/(.+?)\s+(required\s+)?(.*)/', $tag->getContent(), $content);
+                $content = preg_replace('/\s?No-example.?/', '', $content);
+                if (empty($content)) {
+                    // this means only name was supplied
+                    list($name) = preg_split('/\s+/', $tag->getContent());
+                    $required = false;
+                    $description = '';
+                } else {
+                    list($_, $name, $required, $description) = $content;
+                    $description = trim($description);
+                    if ($description == 'required' && empty(trim($required))) {
+                        $required = $description;
+                        $description = '';
+                    }
+                    $required = trim($required) == 'required' ? true : false;
+                }
+
+                list($description, $value) = $this->parseParamDescription($description, 'string');
+                if (is_null($value) && ! $this->shouldExcludeExample($tag->getContent())) {
+                    $value = Str::contains($description, ['number', 'count', 'page'])
+                        ? $this->generateDummyValue('integer')
+                        : $this->generateDummyValue('string');
+                }
+
+                return [$name => compact('description', 'required', 'value')];
+            })->toArray();
+
+        return $parameters;
+    }
+}
diff --git a/src/Http/Controller.php b/src/Http/Controller.php
new file mode 100644
index 00000000..b4c9a28c
--- /dev/null
+++ b/src/Http/Controller.php
@@ -0,0 +1,25 @@
+<?php
+
+namespace Mpociot\ApiDoc\Http;
+
+use Illuminate\Support\Facades\Storage;
+
+class Controller
+{
+    public function html()
+    {
+        return view('apidoc.index');
+    }
+
+    /**
+     * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException
+     *
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function json()
+    {
+        return response()->json(
+            json_decode(Storage::disk(config('apidoc.storage'))->get('apidoc/collection.json'))
+        );
+    }
+}
diff --git a/src/Matching/LumenRouteAdapter.php b/src/Matching/LumenRouteAdapter.php
new file mode 100644
index 00000000..762dae39
--- /dev/null
+++ b/src/Matching/LumenRouteAdapter.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace Mpociot\ApiDoc\Matching;
+
+use Illuminate\Routing\Route;
+
+/**
+ * Class LumenRouteAdapter.
+ * Lumen routes don't extend from Laravel routes,
+ * so we need this class to convert a Lmen route to a Laravel one.
+ */
+class LumenRouteAdapter extends Route
+{
+    /**
+     * LumenRouteAdapter constructor.
+     *
+     * @param array $lumenRoute
+     */
+    public function __construct(array $lumenRoute)
+    {
+        parent::__construct($lumenRoute['method'], $lumenRoute['uri'], $lumenRoute['action']);
+    }
+}
diff --git a/src/Matching/RouteMatcher.php b/src/Matching/RouteMatcher.php
new file mode 100644
index 00000000..9567ff6d
--- /dev/null
+++ b/src/Matching/RouteMatcher.php
@@ -0,0 +1,89 @@
+<?php
+
+namespace Mpociot\ApiDoc\Matching;
+
+use Dingo\Api\Routing\RouteCollection;
+use Illuminate\Routing\Route;
+use Illuminate\Support\Facades\Route as RouteFacade;
+use Illuminate\Support\Str;
+use Mpociot\ApiDoc\Matching\RouteMatcher\Match;
+
+class RouteMatcher implements RouteMatcherInterface
+{
+    public function getRoutes(array $routeRules = [], string $router = 'laravel')
+    {
+        $usingDingoRouter = strtolower($router) == 'dingo';
+
+        return $this->getRoutesToBeDocumented($routeRules, $usingDingoRouter);
+    }
+
+    private function getRoutesToBeDocumented(array $routeRules, bool $usingDingoRouter = false)
+    {
+        $allRoutes = $this->getAllRoutes($usingDingoRouter);
+
+        $matchedRoutes = [];
+
+        foreach ($routeRules as $routeRule) {
+            $includes = $routeRule['include'] ?? [];
+
+            foreach ($allRoutes as $route) {
+                if (is_array($route)) {
+                    $route = new LumenRouteAdapter($route);
+                }
+
+                if ($this->shouldExcludeRoute($route, $routeRule)) {
+                    continue;
+                }
+
+                if ($this->shouldIncludeRoute($route, $routeRule, $includes, $usingDingoRouter)) {
+                    $matchedRoutes[] = new Match($route, $routeRule['apply'] ?? []);
+                }
+            }
+        }
+
+        return $matchedRoutes;
+    }
+
+    private function getAllRoutes(bool $usingDingoRouter)
+    {
+        if (! $usingDingoRouter) {
+            return RouteFacade::getRoutes();
+        }
+
+        $allRouteCollections = app(\Dingo\Api\Routing\Router::class)->getRoutes();
+
+        return collect($allRouteCollections)
+            ->flatMap(function (RouteCollection $collection) {
+                return $collection->getRoutes();
+            })->toArray();
+    }
+
+    private function shouldIncludeRoute(Route $route, array $routeRule, array $mustIncludes, bool $usingDingoRouter)
+    {
+        $matchesVersion = $usingDingoRouter
+            ? ! empty(array_intersect($route->versions(), $routeRule['match']['versions'] ?? []))
+            : true;
+
+        return Str::is($mustIncludes, $route->getName())
+            || Str::is($mustIncludes, $route->uri())
+            || (Str::is($routeRule['match']['domains'] ?? [], $route->getDomain())
+            && Str::is($routeRule['match']['prefixes'] ?? [], $route->uri())
+            && $matchesVersion);
+    }
+
+    private function shouldExcludeRoute(Route $route, array $routeRule)
+    {
+        $excludes = $routeRule['exclude'] ?? [];
+
+        // Exclude this package's routes
+        $excludes[] = 'apidoc';
+
+        // Exclude Laravel Telescope routes
+        if (class_exists("Laravel\Telescope\Telescope")) {
+            $excludes[] = 'telescope/*';
+        }
+
+        return Str::is($excludes, $route->getName())
+            || Str::is($excludes, $route->uri());
+    }
+}
diff --git a/src/Matching/RouteMatcher/Match.php b/src/Matching/RouteMatcher/Match.php
new file mode 100644
index 00000000..0ce6abe8
--- /dev/null
+++ b/src/Matching/RouteMatcher/Match.php
@@ -0,0 +1,78 @@
+<?php
+
+namespace Mpociot\ApiDoc\Matching\RouteMatcher;
+
+use Illuminate\Routing\Route;
+
+class Match implements \ArrayAccess
+{
+    /**
+     * @var Route
+     */
+    protected $route;
+
+    /**
+     * @var array
+     */
+    protected $rules;
+
+    /**
+     * Match constructor.
+     *
+     * @param Route $route
+     * @param array $applyRules
+     */
+    public function __construct(Route $route, array $applyRules)
+    {
+        $this->route = $route;
+        $this->rules = $applyRules;
+    }
+
+    /**
+     * @return Route
+     */
+    public function getRoute()
+    {
+        return $this->route;
+    }
+
+    /**
+     * @return array
+     */
+    public function getRules()
+    {
+        return $this->rules;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function offsetExists($offset)
+    {
+        return is_callable([$this, 'get' . ucfirst($offset)]);
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function offsetGet($offset)
+    {
+        return call_user_func([$this, 'get' . ucfirst($offset)]);
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function offsetSet($offset, $value)
+    {
+        return $this->$offset = $value;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function offsetUnset($offset)
+    {
+        $this->$offset = null;
+    }
+}
diff --git a/src/Matching/RouteMatcherInterface.php b/src/Matching/RouteMatcherInterface.php
new file mode 100644
index 00000000..2cdd166e
--- /dev/null
+++ b/src/Matching/RouteMatcherInterface.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace Mpociot\ApiDoc\Matching;
+
+use Mpociot\ApiDoc\Matching\RouteMatcher\Match;
+
+interface RouteMatcherInterface
+{
+    /**
+     * Resolve matched routes that should be documented.
+     *
+     * @param array $routeRules Route rules defined under the "routes" section in config
+     * @param string $router
+     *
+     * @return Match[]
+     */
+    public function getRoutes(array $routeRules = [], string $router = 'laravel');
+}
diff --git a/src/Mpociot/ApiDoc/ApiDocGeneratorServiceProvider.php b/src/Mpociot/ApiDoc/ApiDocGeneratorServiceProvider.php
deleted file mode 100644
index 125f5f14..00000000
--- a/src/Mpociot/ApiDoc/ApiDocGeneratorServiceProvider.php
+++ /dev/null
@@ -1,58 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc;
-
-use Illuminate\Support\ServiceProvider;
-use Mpociot\ApiDoc\Commands\UpdateDocumentation;
-use Mpociot\ApiDoc\Commands\GenerateDocumentation;
-
-class ApiDocGeneratorServiceProvider extends ServiceProvider
-{
-    /**
-     * Bootstrap the application events.
-     *
-     * @return void
-     */
-    public function boot()
-    {
-        $this->loadViewsFrom(__DIR__.'/../../resources/views/', 'apidoc');
-        $this->loadTranslationsFrom(__DIR__.'/../../resources/lang', 'apidoc');
-
-        $this->publishes([
-            __DIR__.'/../../resources/lang' => $this->resource_path('lang/vendor/apidoc'),
-            __DIR__.'/../../resources/views' => $this->resource_path('views/vendor/apidoc'),
-        ]);
-    }
-
-    /**
-     * Register the API doc commands.
-     *
-     * @return void
-     */
-    public function register()
-    {
-        $this->app->singleton('apidoc.generate', function () {
-            return new GenerateDocumentation();
-        });
-        $this->app->singleton('apidoc.update', function () {
-            return new UpdateDocumentation();
-        });
-
-        $this->commands([
-            'apidoc.generate',
-            'apidoc.update',
-        ]);
-    }
-
-    /**
-     * Return a fully qualified path to a given file.
-     *
-     * @param string $path
-     *
-     * @return string
-     */
-    public function resource_path($path = '')
-    {
-        return app()->basePath().'/resources'.($path ? '/'.$path : $path);
-    }
-}
diff --git a/src/Mpociot/ApiDoc/Commands/GenerateDocumentation.php b/src/Mpociot/ApiDoc/Commands/GenerateDocumentation.php
deleted file mode 100644
index 0ac2dff2..00000000
--- a/src/Mpociot/ApiDoc/Commands/GenerateDocumentation.php
+++ /dev/null
@@ -1,343 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Commands;
-
-use ReflectionClass;
-use Illuminate\Routing\Route;
-use Illuminate\Console\Command;
-use Mpociot\Reflection\DocBlock;
-use Illuminate\Support\Collection;
-use Mpociot\Documentarian\Documentarian;
-use Mpociot\ApiDoc\Postman\CollectionWriter;
-use Mpociot\ApiDoc\Generators\DingoGenerator;
-use Mpociot\ApiDoc\Generators\LaravelGenerator;
-use Mpociot\ApiDoc\Generators\AbstractGenerator;
-use Illuminate\Support\Facades\Route as RouteFacade;
-
-class GenerateDocumentation extends Command
-{
-    /**
-     * The name and signature of the console command.
-     *
-     * @var string
-     */
-    protected $signature = 'api:generate
-                            {--output=public/docs : The output path for the generated documentation}
-                            {--routeDomain= : The route domain (or domains) to use for generation}
-                            {--routePrefix= : The route prefix (or prefixes) to use for generation}
-                            {--routes=* : The route names to use for generation}
-                            {--middleware= : The middleware to use for generation}
-                            {--noResponseCalls : Disable API response calls}
-                            {--noPostmanCollection : Disable Postman collection creation}
-                            {--useMiddlewares : Use all configured route middlewares}
-                            {--authProvider=users : The authentication provider to use for API response calls}
-                            {--authGuard=web : The authentication guard to use for API response calls}
-                            {--actAsUserId= : The user ID to use for API response calls}
-                            {--router=laravel : The router to be used (Laravel or Dingo)}
-                            {--force : Force rewriting of existing routes}
-                            {--bindings= : Route Model Bindings}
-                            {--header=* : Custom HTTP headers to add to the example requests. Separate the header name and value with ":"}
-    ';
-
-    /**
-     * The console command description.
-     *
-     * @var string
-     */
-    protected $description = 'Generate your API documentation from existing Laravel routes.';
-
-    /**
-     * Create a new command instance.
-     *
-     * @return void
-     */
-    public function __construct()
-    {
-        parent::__construct();
-    }
-
-    /**
-     * Execute the console command.
-     *
-     * @return false|null
-     */
-    public function handle()
-    {
-        if ($this->option('router') === 'laravel') {
-            $generator = new LaravelGenerator();
-        } else {
-            $generator = new DingoGenerator();
-        }
-
-        $allowedRoutes = $this->option('routes');
-        $routeDomain = $this->option('routeDomain');
-        $routePrefix = $this->option('routePrefix');
-        $middleware = $this->option('middleware');
-
-        $this->setUserToBeImpersonated($this->option('actAsUserId'));
-
-        if ($routePrefix === null && $routeDomain === null && ! count($allowedRoutes) && $middleware === null) {
-            $this->error('You must provide either a route prefix, a route domain, a route or a middleware to generate the documentation.');
-
-            return false;
-        }
-
-        $generator->prepareMiddleware($this->option('useMiddlewares'));
-
-        $routePrefixes = explode(',', $routePrefix ?: '*');
-        $routeDomains = explode(',', $routeDomain ?: '*');
-
-        $parsedRoutes = [];
-
-        foreach ($routeDomains as $routeDomain) {
-            foreach ($routePrefixes as $routePrefix) {
-                $parsedRoutes += $this->processRoutes($generator, $allowedRoutes, $routeDomain, $routePrefix, $middleware);
-            }
-        }
-        $parsedRoutes = collect($parsedRoutes)->groupBy('resource')->sort(function ($a, $b) {
-            return strcmp($a->first()['resource'], $b->first()['resource']);
-        });
-
-        $this->writeMarkdown($parsedRoutes);
-    }
-
-    /**
-     * @param  Collection $parsedRoutes
-     *
-     * @return void
-     */
-    private function writeMarkdown($parsedRoutes)
-    {
-        $outputPath = $this->option('output');
-        $targetFile = $outputPath.DIRECTORY_SEPARATOR.'source'.DIRECTORY_SEPARATOR.'index.md';
-        $compareFile = $outputPath.DIRECTORY_SEPARATOR.'source'.DIRECTORY_SEPARATOR.'.compare.md';
-        $prependFile = $outputPath.DIRECTORY_SEPARATOR.'source'.DIRECTORY_SEPARATOR.'prepend.md';
-        $appendFile = $outputPath.DIRECTORY_SEPARATOR.'source'.DIRECTORY_SEPARATOR.'append.md';
-
-        $infoText = view('apidoc::partials.info')
-            ->with('outputPath', ltrim($outputPath, 'public/'))
-            ->with('showPostmanCollectionButton', ! $this->option('noPostmanCollection'));
-
-        $parsedRouteOutput = $parsedRoutes->map(function ($routeGroup) {
-            return $routeGroup->map(function ($route) {
-                $route['output'] = (string) view('apidoc::partials.route')->with('parsedRoute', $route)->render();
-
-                return $route;
-            });
-        });
-
-        $frontmatter = view('apidoc::partials.frontmatter');
-        /*
-         * In case the target file already exists, we should check if the documentation was modified
-         * and skip the modified parts of the routes.
-         */
-        if (file_exists($targetFile) && file_exists($compareFile)) {
-            $generatedDocumentation = file_get_contents($targetFile);
-            $compareDocumentation = file_get_contents($compareFile);
-
-            if (preg_match('/---(.*)---\\s<!-- START_INFO -->/is', $generatedDocumentation, $generatedFrontmatter)) {
-                $frontmatter = trim($generatedFrontmatter[1], "\n");
-            }
-
-            $parsedRouteOutput->transform(function ($routeGroup) use ($generatedDocumentation, $compareDocumentation) {
-                return $routeGroup->transform(function ($route) use ($generatedDocumentation, $compareDocumentation) {
-                    if (preg_match('/<!-- START_'.$route['id'].' -->(.*)<!-- END_'.$route['id'].' -->/is', $generatedDocumentation, $routeMatch)) {
-                        $routeDocumentationChanged = (preg_match('/<!-- START_'.$route['id'].' -->(.*)<!-- END_'.$route['id'].' -->/is', $compareDocumentation, $compareMatch) && $compareMatch[1] !== $routeMatch[1]);
-                        if ($routeDocumentationChanged === false || $this->option('force')) {
-                            if ($routeDocumentationChanged) {
-                                $this->warn('Discarded manual changes for route ['.implode(',', $route['methods']).'] '.$route['uri']);
-                            }
-                        } else {
-                            $this->warn('Skipping modified route ['.implode(',', $route['methods']).'] '.$route['uri']);
-                            $route['modified_output'] = $routeMatch[0];
-                        }
-                    }
-
-                    return $route;
-                });
-            });
-        }
-
-        $prependFileContents = file_exists($prependFile)
-            ? file_get_contents($prependFile)."\n" : '';
-        $appendFileContents = file_exists($appendFile)
-            ? "\n".file_get_contents($appendFile) : '';
-
-        $documentarian = new Documentarian();
-
-        $markdown = view('apidoc::documentarian')
-            ->with('writeCompareFile', false)
-            ->with('frontmatter', $frontmatter)
-            ->with('infoText', $infoText)
-            ->with('prependMd', $prependFileContents)
-            ->with('appendMd', $appendFileContents)
-            ->with('outputPath', $this->option('output'))
-            ->with('showPostmanCollectionButton', ! $this->option('noPostmanCollection'))
-            ->with('parsedRoutes', $parsedRouteOutput);
-
-        if (! is_dir($outputPath)) {
-            $documentarian->create($outputPath);
-        }
-
-        // Write output file
-        file_put_contents($targetFile, $markdown);
-
-        // Write comparable markdown file
-        $compareMarkdown = view('apidoc::documentarian')
-            ->with('writeCompareFile', true)
-            ->with('frontmatter', $frontmatter)
-            ->with('infoText', $infoText)
-            ->with('prependMd', $prependFileContents)
-            ->with('appendMd', $appendFileContents)
-            ->with('outputPath', $this->option('output'))
-            ->with('showPostmanCollectionButton', ! $this->option('noPostmanCollection'))
-            ->with('parsedRoutes', $parsedRouteOutput);
-
-        file_put_contents($compareFile, $compareMarkdown);
-
-        $this->info('Wrote index.md to: '.$outputPath);
-
-        $this->info('Generating API HTML code');
-
-        $documentarian->generate($outputPath);
-
-        $this->info('Wrote HTML documentation to: '.$outputPath.'/index.html');
-
-        if ($this->option('noPostmanCollection') !== true) {
-            $this->info('Generating Postman collection');
-
-            file_put_contents($outputPath.DIRECTORY_SEPARATOR.'collection.json', $this->generatePostmanCollection($parsedRoutes));
-        }
-    }
-
-    /**
-     * @return array
-     */
-    private function getBindings()
-    {
-        $bindings = $this->option('bindings');
-        if (empty($bindings)) {
-            return [];
-        }
-
-        $bindings = explode('|', $bindings);
-        $resultBindings = [];
-        foreach ($bindings as $binding) {
-            list($name, $id) = explode(',', $binding);
-            $resultBindings[$name] = $id;
-        }
-
-        return $resultBindings;
-    }
-
-    /**
-     * @param $actAs
-     */
-    private function setUserToBeImpersonated($actAs)
-    {
-        if (! empty($actAs)) {
-            if (version_compare($this->laravel->version(), '5.2.0', '<')) {
-                $userModel = config('auth.model');
-                $user = $userModel::find($actAs);
-                $this->laravel['auth']->setUser($user);
-            } else {
-                $provider = $this->option('authProvider');
-                $userModel = config("auth.providers.$provider.model");
-                $user = $userModel::find($actAs);
-                $this->laravel['auth']->guard($this->option('authGuard'))->setUser($user);
-            }
-        }
-    }
-
-    /**
-     * @return mixed
-     */
-    private function getRoutes()
-    {
-        if ($this->option('router') === 'laravel') {
-            return RouteFacade::getRoutes();
-        } else {
-            return app('Dingo\Api\Routing\Router')->getRoutes();
-        }
-    }
-
-    /**
-     * @param AbstractGenerator  $generator
-     * @param $allowedRoutes
-     * @param $routeDomain
-     * @param $routePrefix
-     *
-     * @return array
-     */
-    private function processRoutes(AbstractGenerator $generator, array $allowedRoutes, $routeDomain, $routePrefix, $middleware)
-    {
-        $withResponse = $this->option('noResponseCalls') == false;
-        $routes = $this->getRoutes();
-        $bindings = $this->getBindings();
-        $parsedRoutes = [];
-        foreach ($routes as $route) {
-            /** @var Route $route */
-            if (in_array($route->getName(), $allowedRoutes)
-                || (str_is($routeDomain, $generator->getDomain($route))
-                    && str_is($routePrefix, $generator->getUri($route)))
-                || in_array($middleware, $route->middleware())
-               ) {
-                if ($this->isValidRoute($route) && $this->isRouteVisibleForDocumentation($route->getAction()['uses'])) {
-                    $parsedRoutes[] = $generator->processRoute($route, $bindings, $this->option('header'), $withResponse && in_array('GET', $generator->getMethods($route)));
-                    $this->info('Processed route: ['.implode(',', $generator->getMethods($route)).'] '.$generator->getUri($route));
-                } else {
-                    $this->warn('Skipping route: ['.implode(',', $generator->getMethods($route)).'] '.$generator->getUri($route));
-                }
-            }
-        }
-
-        return $parsedRoutes;
-    }
-
-    /**
-     * @param $route
-     *
-     * @return bool
-     */
-    private function isValidRoute(Route $route)
-    {
-        return ! is_callable($route->getAction()['uses']) && ! is_null($route->getAction()['uses']);
-    }
-
-    /**
-     * @param $route
-     *
-     * @return bool
-     */
-    private function isRouteVisibleForDocumentation($route)
-    {
-        list($class, $method) = explode('@', $route);
-        $reflection = new ReflectionClass($class);
-        $comment = $reflection->getMethod($method)->getDocComment();
-        if ($comment) {
-            $phpdoc = new DocBlock($comment);
-
-            return collect($phpdoc->getTags())
-                ->filter(function ($tag) use ($route) {
-                    return $tag->getName() === 'hideFromAPIDocumentation';
-                })
-                ->isEmpty();
-        }
-
-        return true;
-    }
-
-    /**
-     * Generate Postman collection JSON file.
-     *
-     * @param Collection $routes
-     *
-     * @return string
-     */
-    private function generatePostmanCollection(Collection $routes)
-    {
-        $writer = new CollectionWriter($routes);
-
-        return $writer->getCollection();
-    }
-}
diff --git a/src/Mpociot/ApiDoc/Commands/UpdateDocumentation.php b/src/Mpociot/ApiDoc/Commands/UpdateDocumentation.php
deleted file mode 100644
index 79a58380..00000000
--- a/src/Mpociot/ApiDoc/Commands/UpdateDocumentation.php
+++ /dev/null
@@ -1,58 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Commands;
-
-use Illuminate\Console\Command;
-use Mpociot\Documentarian\Documentarian;
-
-class UpdateDocumentation extends Command
-{
-    /**
-     * The name and signature of the console command.
-     *
-     * @var string
-     */
-    protected $signature = 'api:update 
-                            {--location=public/docs : The documentation location}
-    ';
-
-    /**
-     * The console command description.
-     *
-     * @var string
-     */
-    protected $description = 'Update and rebuild your API documentation from your markdown file.';
-
-    /**
-     * Create a new command instance.
-     *
-     * @return void
-     */
-    public function __construct()
-    {
-        parent::__construct();
-    }
-
-    /**
-     * Execute the console command.
-     *
-     * @return false|null
-     */
-    public function handle()
-    {
-        $outputPath = $this->option('location');
-
-        $documentarian = new Documentarian();
-
-        if (! is_dir($outputPath)) {
-            $this->error('There is no generated documentation available at '.$outputPath.'.');
-
-            return false;
-        }
-        $this->info('Updating API HTML code');
-
-        $documentarian->generate($outputPath);
-
-        $this->info('Wrote HTML documentation to: '.$outputPath.'/index.html');
-    }
-}
diff --git a/src/Mpociot/ApiDoc/Generators/AbstractGenerator.php b/src/Mpociot/ApiDoc/Generators/AbstractGenerator.php
deleted file mode 100644
index 74594489..00000000
--- a/src/Mpociot/ApiDoc/Generators/AbstractGenerator.php
+++ /dev/null
@@ -1,790 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Generators;
-
-use Faker\Factory;
-use ReflectionClass;
-use Illuminate\Support\Arr;
-use Illuminate\Support\Str;
-use League\Fractal\Manager;
-use Illuminate\Routing\Route;
-use Mpociot\Reflection\DocBlock;
-use League\Fractal\Resource\Item;
-use Mpociot\Reflection\DocBlock\Tag;
-use League\Fractal\Resource\Collection;
-use Illuminate\Support\Facades\Validator;
-use Illuminate\Foundation\Http\FormRequest;
-use Mpociot\ApiDoc\Parsers\RuleDescriptionParser as Description;
-use Illuminate\Contracts\Validation\Factory as ValidationFactory;
-
-abstract class AbstractGenerator
-{
-    /**
-     * @param Route $route
-     *
-     * @return mixed
-     */
-    public function getDomain(Route $route)
-    {
-        return $route->domain();
-    }
-
-    /**
-     * @param Route $route
-     *
-     * @return mixed
-     */
-    public function getUri(Route $route)
-    {
-        return $route->uri();
-    }
-
-    /**
-     * @param Route $route
-     *
-     * @return mixed
-     */
-    public function getMethods(Route $route)
-    {
-        return array_diff($route->methods(), ['HEAD']);
-    }
-
-    /**
-     * @param  \Illuminate\Routing\Route $route
-     * @param array $bindings
-     * @param bool $withResponse
-     *
-     * @return array
-     */
-    public function processRoute($route, $bindings = [], $headers = [], $withResponse = true)
-    {
-        $routeDomain = $route->domain();
-        $routeAction = $route->getAction();
-        $routeGroup = $this->getRouteGroup($routeAction['uses']);
-        $routeDescription = $this->getRouteDescription($routeAction['uses']);
-        $showresponse = null;
-
-        // set correct route domain
-        $headers[] = "HTTP_HOST: {$routeDomain}";
-        $headers[] = "SERVER_NAME: {$routeDomain}";
-
-        $response = null;
-        $docblockResponse = $this->getDocblockResponse($routeDescription['tags']);
-        if ($docblockResponse) {
-            // we have a response from the docblock ( @response )
-            $response = $docblockResponse;
-            $showresponse = true;
-        }
-        if (! $response) {
-            $transformerResponse = $this->getTransformerResponse($routeDescription['tags']);
-            if ($transformerResponse) {
-                // we have a transformer response from the docblock ( @transformer || @transformercollection )
-                $response = $transformerResponse;
-                $showresponse = true;
-            }
-        }
-        if (! $response && $withResponse) {
-            try {
-                $response = $this->getRouteResponse($route, $bindings, $headers);
-            } catch (\Exception $e) {
-                echo "Couldn't get response for route: ".implode(',', $this->getMethods($route)).$route->uri().']: '.$e->getMessage()."\n";
-            }
-        }
-
-        $content = $this->getResponseContent($response);
-
-        return $this->getParameters([
-            'id' => md5($this->getUri($route).':'.implode($this->getMethods($route))),
-            'resource' => $routeGroup,
-            'title' => $routeDescription['short'],
-            'description' => $routeDescription['long'],
-            'methods' => $this->getMethods($route),
-            'uri' => $this->getUri($route),
-            'parameters' => [],
-            'response' => $content,
-            'showresponse' => $showresponse,
-        ], $routeAction, $bindings);
-    }
-
-    /**
-     * Prepares / Disables route middlewares.
-     *
-     * @param  bool $disable
-     *
-     * @return  void
-     */
-    abstract public function prepareMiddleware($enable = false);
-
-    /**
-     * Get the response from the docblock if available.
-     *
-     * @param array $tags
-     *
-     * @return mixed
-     */
-    protected function getDocblockResponse($tags)
-    {
-        $responseTags = array_filter($tags, function ($tag) {
-            if (! ($tag instanceof Tag)) {
-                return false;
-            }
-
-            return \strtolower($tag->getName()) == 'response';
-        });
-        if (empty($responseTags)) {
-            return;
-        }
-        $responseTag = \array_first($responseTags);
-
-        return \response(json_encode($responseTag->getContent()), 200, ['Content-Type' => 'application/json']);
-    }
-
-    /**
-     * @param array $routeData
-     * @param array $routeAction
-     * @param array $bindings
-     *
-     * @return mixed
-     */
-    protected function getParameters($routeData, $routeAction, $bindings)
-    {
-        $validationRules = $this->getRouteValidationRules($routeData['methods'], $routeAction['uses'], $bindings);
-        $rules = $this->simplifyRules($validationRules);
-
-        foreach ($rules as $attribute => $ruleset) {
-            $attributeData = [
-                'required' => false,
-                'type' => null,
-                'default' => '',
-                'value' => '',
-                'description' => [],
-            ];
-            foreach ($ruleset as $rule) {
-                $this->parseRule($rule, $attribute, $attributeData, $routeData['id'], $routeData);
-            }
-            $routeData['parameters'][$attribute] = $attributeData;
-        }
-
-        return $routeData;
-    }
-
-    /**
-     * Format the validation rules as a plain array.
-     *
-     * @param array $rules
-     *
-     * @return array
-     */
-    protected function simplifyRules($rules)
-    {
-        // this will split all string rules into arrays of strings
-        $newRules = Validator::make([], $rules)->getRules();
-
-        // Laravel will ignore the nested array rules unless the key referenced exists and is an array
-        // So we'll create an empty array for each array attribute
-        $values = collect($newRules)
-            ->filter(function ($values) {
-                return in_array('array', $values);
-            })->map(function ($val, $key) {
-                return [str_random()];
-            })->all();
-
-        // Now this will return the complete ruleset.
-        // Nested array parameters will be present, with '*' replaced by '0'
-        return Validator::make($values, $rules)->getRules();
-    }
-
-    /**
-     * @param  $route
-     * @param  $bindings
-     * @param  $headers
-     *
-     * @return \Illuminate\Http\Response
-     */
-    protected function getRouteResponse($route, $bindings, $headers = [])
-    {
-        $uri = $this->addRouteModelBindings($route, $bindings);
-
-        $methods = $this->getMethods($route);
-
-        // Split headers into key - value pairs
-        $headers = collect($headers)->map(function ($value) {
-            $split = explode(':', $value); // explode to get key + values
-            $key = array_shift($split); // extract the key and keep the values in the array
-            $value = implode(':', $split); // implode values into string again
-
-            return [trim($key) => trim($value)];
-        })->collapse()->toArray();
-
-        //Changes url with parameters like /users/{user} to /users/1
-        $uri = preg_replace('/{(.*?)}/', 1, $uri); // 1 is the default value for route parameters
-
-        return $this->callRoute(array_shift($methods), $uri, [], [], [], $headers);
-    }
-
-    /**
-     * @param $route
-     * @param array $bindings
-     *
-     * @return mixed
-     */
-    protected function addRouteModelBindings($route, $bindings)
-    {
-        $uri = $this->getUri($route);
-        foreach ($bindings as $model => $id) {
-            $uri = str_replace('{'.$model.'}', $id, $uri);
-            $uri = str_replace('{'.$model.'?}', $id, $uri);
-        }
-
-        return $uri;
-    }
-
-    /**
-     * @param  \Illuminate\Routing\Route  $route
-     *
-     * @return array
-     */
-    protected function getRouteDescription($route)
-    {
-        list($class, $method) = explode('@', $route);
-        $reflection = new ReflectionClass($class);
-        $reflectionMethod = $reflection->getMethod($method);
-
-        $comment = $reflectionMethod->getDocComment();
-        $phpdoc = new DocBlock($comment);
-
-        return [
-            'short' => $phpdoc->getShortDescription(),
-            'long' => $phpdoc->getLongDescription()->getContents(),
-            'tags' => $phpdoc->getTags(),
-        ];
-    }
-
-    /**
-     * @param  string  $route
-     *
-     * @return string
-     */
-    protected function getRouteGroup($route)
-    {
-        list($class, $method) = explode('@', $route);
-        $reflection = new ReflectionClass($class);
-        $comment = $reflection->getDocComment();
-        if ($comment) {
-            $phpdoc = new DocBlock($comment);
-            foreach ($phpdoc->getTags() as $tag) {
-                if ($tag->getName() === 'resource') {
-                    return $tag->getContent();
-                }
-            }
-        }
-
-        return 'general';
-    }
-
-    /**
-     * @param  array $routeMethods
-     * @param  string $routeAction
-     * @param  array $bindings
-     *
-     * @return array
-     */
-    protected function getRouteValidationRules(array $routeMethods, $routeAction, $bindings)
-    {
-        list($controller, $method) = explode('@', $routeAction);
-        $reflection = new ReflectionClass($controller);
-        $reflectionMethod = $reflection->getMethod($method);
-
-        foreach ($reflectionMethod->getParameters() as $parameter) {
-            $parameterType = $parameter->getClass();
-            if (! is_null($parameterType) && class_exists($parameterType->name)) {
-                $className = $parameterType->name;
-
-                if (is_subclass_of($className, FormRequest::class)) {
-                    /** @var FormRequest $formRequest */
-                    $formRequest = new $className;
-                    // Add route parameter bindings
-                    $formRequest->setContainer(app());
-                    $formRequest->request->add($bindings);
-                    $formRequest->query->add($bindings);
-                    $formRequest->setMethod($routeMethods[0]);
-
-                    if (method_exists($formRequest, 'validator')) {
-                        $factory = app(ValidationFactory::class);
-
-                        return call_user_func_array([$formRequest, 'validator'], [$factory])
-                            ->getRules();
-                    } else {
-                        return call_user_func_array([$formRequest, 'rules'], []);
-                    }
-                }
-            }
-        }
-
-        return [];
-    }
-
-    /**
-     * @param  array  $arr
-     * @param  string  $first
-     * @param  string  $last
-     *
-     * @return string
-     */
-    protected function fancyImplode($arr, $first, $last)
-    {
-        $arr = array_map(function ($value) {
-            return '`'.$value.'`';
-        }, $arr);
-        array_push($arr, implode($last, array_splice($arr, -2)));
-
-        return implode($first, $arr);
-    }
-
-    protected function splitValuePairs($parameters, $first = 'is ', $last = 'or ')
-    {
-        $attribute = '';
-        collect($parameters)->map(function ($item, $key) use (&$attribute, $first, $last) {
-            $attribute .= '`'.$item.'` ';
-            if (($key + 1) % 2 === 0) {
-                $attribute .= $last;
-            } else {
-                $attribute .= $first;
-            }
-        });
-        $attribute = rtrim($attribute, $last);
-
-        return $attribute;
-    }
-
-    /**
-     * @param  string  $rule
-     * @param  string  $attribute
-     * @param  array  $attributeData
-     * @param  int  $seed
-     *
-     * @return void
-     */
-    protected function parseRule($rule, $attribute, &$attributeData, $seed, $routeData)
-    {
-        $faker = Factory::create();
-        $faker->seed(crc32($seed));
-
-        $parsedRule = $this->parseStringRule($rule);
-        $parsedRule[0] = $this->normalizeRule($parsedRule[0]);
-        list($rule, $parameters) = $parsedRule;
-
-        switch ($rule) {
-            case 'required':
-                $attributeData['required'] = true;
-                break;
-            case 'accepted':
-                $attributeData['required'] = true;
-                $attributeData['type'] = 'boolean';
-                $attributeData['value'] = true;
-                break;
-            case 'after':
-                $attributeData['type'] = 'date';
-                $format = isset($attributeData['format']) ? $attributeData['format'] : DATE_RFC850;
-
-                if (strtotime($parameters[0]) === false) {
-                    // the `after` date refers to another parameter in the request
-                    $paramName = $parameters[0];
-                    $attributeData['description'][] = Description::parse($rule)->with($paramName)->getDescription();
-                    $attributeData['value'] = date($format, strtotime('+1 day', strtotime($routeData['parameters'][$paramName]['value'])));
-                } else {
-                    $attributeData['description'][] = Description::parse($rule)->with(date($format, strtotime($parameters[0])))->getDescription();
-                    $attributeData['value'] = date($format, strtotime('+1 day', strtotime($parameters[0])));
-                }
-                break;
-            case 'alpha':
-                $attributeData['description'][] = Description::parse($rule)->getDescription();
-                $attributeData['value'] = $faker->word;
-                break;
-            case 'alpha_dash':
-                $attributeData['description'][] = Description::parse($rule)->getDescription();
-                break;
-            case 'alpha_num':
-                $attributeData['description'][] = Description::parse($rule)->getDescription();
-                break;
-            case 'in':
-                $attributeData['description'][] = Description::parse($rule)->with($this->fancyImplode($parameters, ', ', ' or '))->getDescription();
-                $attributeData['value'] = $faker->randomElement($parameters);
-                break;
-            case 'not_in':
-                $attributeData['description'][] = Description::parse($rule)->with($this->fancyImplode($parameters, ', ', ' or '))->getDescription();
-                $attributeData['value'] = $faker->word;
-                break;
-            case 'min':
-                $attributeData['description'][] = Description::parse($rule)->with($parameters)->getDescription();
-                if (Arr::get($attributeData, 'type') === 'numeric' || Arr::get($attributeData, 'type') === 'integer') {
-                    $attributeData['value'] = $faker->numberBetween($parameters[0]);
-                }
-                break;
-            case 'max':
-                $attributeData['description'][] = Description::parse($rule)->with($parameters)->getDescription();
-                if (Arr::get($attributeData, 'type') === 'numeric' || Arr::get($attributeData, 'type') === 'integer') {
-                    $attributeData['value'] = $faker->numberBetween(0, $parameters[0]);
-                }
-                break;
-            case 'between':
-                if (! isset($attributeData['type'])) {
-                    $attributeData['type'] = 'numeric';
-                }
-                $attributeData['description'][] = Description::parse($rule)->with($parameters)->getDescription();
-                $attributeData['value'] = $faker->numberBetween($parameters[0], $parameters[1]);
-                break;
-            case 'before':
-                $attributeData['type'] = 'date';
-                $format = isset($attributeData['format']) ? $attributeData['format'] : DATE_RFC850;
-
-                if (strtotime($parameters[0]) === false) {
-                    // the `before` date refers to another parameter in the request
-                    $paramName = $parameters[0];
-                    $attributeData['description'][] = Description::parse($rule)->with($paramName)->getDescription();
-                    $attributeData['value'] = date($format, strtotime('-1 day', strtotime($routeData['parameters'][$paramName]['value'])));
-                } else {
-                    $attributeData['description'][] = Description::parse($rule)->with(date($format, strtotime($parameters[0])))->getDescription();
-                    $attributeData['value'] = date($format, strtotime('-1 day', strtotime($parameters[0])));
-                }
-                break;
-            case 'date_format':
-                $attributeData['type'] = 'date';
-                $attributeData['description'][] = Description::parse($rule)->with($parameters)->getDescription();
-                $attributeData['format'] = $parameters[0];
-                $attributeData['value'] = date($attributeData['format']);
-                break;
-            case 'different':
-                $attributeData['description'][] = Description::parse($rule)->with($parameters)->getDescription();
-                break;
-            case 'digits':
-                $attributeData['type'] = 'numeric';
-                $attributeData['description'][] = Description::parse($rule)->with($parameters)->getDescription();
-                $attributeData['value'] = ($parameters[0] < 9) ? $faker->randomNumber($parameters[0], true) : substr(mt_rand(100000000, mt_getrandmax()), 0, $parameters[0]);
-                break;
-            case 'digits_between':
-                $attributeData['type'] = 'numeric';
-                $attributeData['description'][] = Description::parse($rule)->with($parameters)->getDescription();
-                break;
-            case 'file':
-                $attributeData['type'] = 'file';
-                $attributeData['description'][] = Description::parse($rule)->getDescription();
-                break;
-            case 'image':
-                $attributeData['type'] = 'image';
-                $attributeData['description'][] = Description::parse($rule)->getDescription();
-                break;
-            case 'json':
-                $attributeData['type'] = 'string';
-                $attributeData['description'][] = Description::parse($rule)->getDescription();
-                $attributeData['value'] = json_encode(['foo', 'bar', 'baz']);
-                break;
-            case 'mimetypes':
-            case 'mimes':
-                $attributeData['description'][] = Description::parse($rule)->with($this->fancyImplode($parameters, ', ', ' or '))->getDescription();
-                break;
-            case 'required_if':
-                $attributeData['description'][] = Description::parse($rule)->with($this->splitValuePairs($parameters))->getDescription();
-                break;
-            case 'required_unless':
-                $attributeData['description'][] = Description::parse($rule)->with($this->splitValuePairs($parameters))->getDescription();
-                break;
-            case 'required_with':
-                $attributeData['description'][] = Description::parse($rule)->with($this->fancyImplode($parameters, ', ', ' or '))->getDescription();
-                break;
-            case 'required_with_all':
-                $attributeData['description'][] = Description::parse($rule)->with($this->fancyImplode($parameters, ', ', ' and '))->getDescription();
-                break;
-            case 'required_without':
-                $attributeData['description'][] = Description::parse($rule)->with($this->fancyImplode($parameters, ', ', ' or '))->getDescription();
-                break;
-            case 'required_without_all':
-                $attributeData['description'][] = Description::parse($rule)->with($this->fancyImplode($parameters, ', ', ' and '))->getDescription();
-                break;
-            case 'same':
-                $attributeData['description'][] = Description::parse($rule)->with($parameters)->getDescription();
-                break;
-            case 'size':
-                $attributeData['description'][] = Description::parse($rule)->with($parameters)->getDescription();
-                break;
-            case 'timezone':
-                $attributeData['description'][] = Description::parse($rule)->getDescription();
-                $attributeData['value'] = $faker->timezone;
-                break;
-            case 'exists':
-                $fieldName = isset($parameters[1]) ? $parameters[1] : $attribute;
-                $attributeData['description'][] = Description::parse($rule)->with([Str::singular($parameters[0]), $fieldName])->getDescription();
-                break;
-            case 'active_url':
-                $attributeData['type'] = 'url';
-                $attributeData['value'] = $faker->url;
-                break;
-            case 'regex':
-                $attributeData['type'] = 'string';
-                $attributeData['description'][] = Description::parse($rule)->with($parameters)->getDescription();
-                break;
-            case 'boolean':
-                $attributeData['value'] = true;
-                $attributeData['type'] = $rule;
-                break;
-            case 'array':
-                $attributeData['value'] = [$faker->word];
-                $attributeData['type'] = $rule;
-                $attributeData['description'][] = Description::parse($rule)->getDescription();
-                break;
-            case 'date':
-                $attributeData['value'] = $faker->date();
-                $attributeData['type'] = $rule;
-                break;
-            case 'email':
-                $attributeData['value'] = $faker->safeEmail;
-                $attributeData['type'] = $rule;
-                break;
-            case 'string':
-                $attributeData['value'] = $faker->word;
-                $attributeData['type'] = $rule;
-                break;
-            case 'integer':
-                $attributeData['value'] = $faker->randomNumber();
-                $attributeData['type'] = $rule;
-                break;
-            case 'numeric':
-                $attributeData['value'] = $faker->randomNumber();
-                $attributeData['type'] = $rule;
-                break;
-            case 'url':
-                $attributeData['value'] = $faker->url;
-                $attributeData['type'] = $rule;
-                break;
-            case 'ip':
-                $attributeData['value'] = $faker->ipv4;
-                $attributeData['type'] = $rule;
-                break;
-            default:
-                $unknownRuleDescription = Description::parse($rule)->getDescription();
-                if ($unknownRuleDescription) {
-                    $attributeData['description'][] = $unknownRuleDescription;
-                }
-                break;
-        }
-
-        if ($attributeData['value'] === '') {
-            $attributeData['value'] = $faker->word;
-        }
-
-        if (is_null($attributeData['type'])) {
-            $attributeData['type'] = 'string';
-        }
-    }
-
-    /**
-     * Call the given URI and return the Response.
-     *
-     * @param  string  $method
-     * @param  string  $uri
-     * @param  array  $parameters
-     * @param  array  $cookies
-     * @param  array  $files
-     * @param  array  $server
-     * @param  string  $content
-     *
-     * @return \Illuminate\Http\Response
-     */
-    abstract public function callRoute($method, $uri, $parameters = [], $cookies = [], $files = [], $server = [], $content = null);
-
-    /**
-     * Transform headers array to array of $_SERVER vars with HTTP_* format.
-     *
-     * @param  array  $headers
-     *
-     * @return array
-     */
-    protected function transformHeadersToServerVars(array $headers)
-    {
-        $server = [];
-        $prefix = 'HTTP_';
-
-        foreach ($headers as $name => $value) {
-            $name = strtr(strtoupper($name), '-', '_');
-
-            if (! Str::startsWith($name, $prefix) && $name !== 'CONTENT_TYPE') {
-                $name = $prefix.$name;
-            }
-
-            $server[$name] = $value;
-        }
-
-        return $server;
-    }
-
-    /**
-     * Parse a string based rule.
-     *
-     * @param  string  $rules
-     *
-     * @return array
-     */
-    protected function parseStringRule($rules)
-    {
-        $parameters = [];
-
-        // The format for specifying validation rules and parameters follows an
-        // easy {rule}:{parameters} formatting convention. For instance the
-        // rule "max:3" states that the value may only be three letters.
-        if (strpos($rules, ':') !== false) {
-            list($rules, $parameter) = explode(':', $rules, 2);
-
-            $parameters = $this->parseParameters($rules, $parameter);
-        }
-
-        return [strtolower(trim($rules)), $parameters];
-    }
-
-    /**
-     * Parse a parameter list.
-     *
-     * @param  string  $rule
-     * @param  string  $parameter
-     *
-     * @return array
-     */
-    protected function parseParameters($rule, $parameter)
-    {
-        if (strtolower($rule) === 'regex') {
-            return [$parameter];
-        }
-
-        return str_getcsv($parameter);
-    }
-
-    /**
-     * Normalizes a rule so that we can accept short types.
-     *
-     * @param  string $rule
-     *
-     * @return string
-     */
-    protected function normalizeRule($rule)
-    {
-        switch ($rule) {
-            case 'int':
-                return 'integer';
-            case 'bool':
-                return 'boolean';
-            default:
-                return $rule;
-        }
-    }
-
-    /**
-     * @param $response
-     *
-     * @return mixed
-     */
-    private function getResponseContent($response)
-    {
-        if (empty($response)) {
-            return '';
-        }
-        if ($response->headers->get('Content-Type') === 'application/json') {
-            $content = json_decode($response->getContent(), JSON_PRETTY_PRINT);
-        } else {
-            $content = $response->getContent();
-        }
-
-        return $content;
-    }
-
-    /**
-     * Get a response from the transformer tags.
-     *
-     * @param array $tags
-     *
-     * @return mixed
-     */
-    protected function getTransformerResponse($tags)
-    {
-        try {
-            $transFormerTags = array_filter($tags, function ($tag) {
-                if (! ($tag instanceof Tag)) {
-                    return false;
-                }
-
-                return \in_array(\strtolower($tag->getName()), ['transformer', 'transformercollection']);
-            });
-            if (empty($transFormerTags)) {
-                // we didn't have any of the tags so goodbye
-                return false;
-            }
-
-            $modelTag = array_first(array_filter($tags, function ($tag) {
-                if (! ($tag instanceof Tag)) {
-                    return false;
-                }
-
-                return \in_array(\strtolower($tag->getName()), ['transformermodel']);
-            }));
-            $tag = \array_first($transFormerTags);
-            $transformer = $tag->getContent();
-            if (! \class_exists($transformer)) {
-                // if we can't find the transformer we can't generate a response
-                return;
-            }
-            $demoData = [];
-
-            $reflection = new ReflectionClass($transformer);
-            $method = $reflection->getMethod('transform');
-            $parameter = \array_first($method->getParameters());
-            $type = null;
-            if ($modelTag) {
-                $type = $modelTag->getContent();
-            }
-            if (version_compare(PHP_VERSION, '7.0.0') >= 0 && \is_null($type)) {
-                // we can only get the type with reflection for PHP 7
-                if ($parameter->hasType() &&
-                    ! $parameter->getType()->isBuiltin() &&
-                    \class_exists((string) $parameter->getType())) {
-                    //we have a type
-                    $type = (string) $parameter->getType();
-                }
-            }
-            if ($type) {
-                // we have a class so we try to create an instance
-                $demoData = new $type;
-                try {
-                    // try a factory
-                    $demoData = \factory($type)->make();
-                } catch (\Exception $e) {
-                    if ($demoData instanceof \Illuminate\Database\Eloquent\Model) {
-                        // we can't use a factory but can try to get one from the database
-                        try {
-                            // check if we can find one
-                            $newDemoData = $type::first();
-                            if ($newDemoData) {
-                                $demoData = $newDemoData;
-                            }
-                        } catch (\Exception $e) {
-                            // do nothing
-                        }
-                    }
-                }
-            }
-
-            $fractal = new Manager();
-            $resource = [];
-            if ($tag->getName() == 'transformer') {
-                // just one
-                $resource = new Item($demoData, new $transformer);
-            }
-            if ($tag->getName() == 'transformercollection') {
-                // a collection
-                $resource = new Collection([$demoData, $demoData], new $transformer);
-            }
-
-            return \response($fractal->createData($resource)->toJson());
-        } catch (\Exception $e) {
-            // it isn't possible to parse the transformer
-            return;
-        }
-    }
-}
diff --git a/src/Mpociot/ApiDoc/Generators/DingoGenerator.php b/src/Mpociot/ApiDoc/Generators/DingoGenerator.php
deleted file mode 100644
index 314d3c70..00000000
--- a/src/Mpociot/ApiDoc/Generators/DingoGenerator.php
+++ /dev/null
@@ -1,33 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Generators;
-
-class DingoGenerator extends AbstractGenerator
-{
-    /**
-     * Prepares / Disables route middlewares.
-     *
-     * @param  bool $disable
-     *
-     * @return  void
-     */
-    public function prepareMiddleware($disable = true)
-    {
-        // Not needed by Dingo
-        return false;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function callRoute($method, $uri, $parameters = [], $cookies = [], $files = [], $server = [], $content = null)
-    {
-        $dispatcher = app('Dingo\Api\Dispatcher')->raw();
-
-        collect($server)->map(function ($key, $value) use ($dispatcher) {
-            $dispatcher->header($value, $key);
-        });
-
-        return call_user_func_array([$dispatcher, strtolower($method)], [$uri]);
-    }
-}
diff --git a/src/Mpociot/ApiDoc/Generators/LaravelGenerator.php b/src/Mpociot/ApiDoc/Generators/LaravelGenerator.php
deleted file mode 100644
index 3efd4241..00000000
--- a/src/Mpociot/ApiDoc/Generators/LaravelGenerator.php
+++ /dev/null
@@ -1,85 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Generators;
-
-use Illuminate\Routing\Route;
-use Illuminate\Support\Facades\App;
-use Illuminate\Support\Facades\Request;
-
-class LaravelGenerator extends AbstractGenerator
-{
-    /**
-     * @param Route $route
-     *
-     * @return mixed
-     */
-    public function getUri(Route $route)
-    {
-        if (version_compare(app()->version(), '5.4', '<')) {
-            return $route->getUri();
-        }
-
-        return $route->uri();
-    }
-
-    /**
-     * @param Route $route
-     *
-     * @return mixed
-     */
-    public function getMethods(Route $route)
-    {
-        if (version_compare(app()->version(), '5.4', '<')) {
-            $methods = $route->getMethods();
-        } else {
-            $methods = $route->methods();
-        }
-
-        return array_diff($methods, ['HEAD']);
-    }
-
-    /**
-     * Prepares / Disables route middlewares.
-     *
-     * @param  bool $disable
-     *
-     * @return  void
-     */
-    public function prepareMiddleware($enable = true)
-    {
-        App::instance('middleware.disable', ! $enable);
-    }
-
-    /**
-     * Call the given URI and return the Response.
-     *
-     * @param  string  $method
-     * @param  string  $uri
-     * @param  array  $parameters
-     * @param  array  $cookies
-     * @param  array  $files
-     * @param  array  $server
-     * @param  string  $content
-     *
-     * @return \Illuminate\Http\Response
-     */
-    public function callRoute($method, $uri, $parameters = [], $cookies = [], $files = [], $server = [], $content = null)
-    {
-        $server = collect([
-            'CONTENT_TYPE' => 'application/json',
-            'Accept' => 'application/json',
-        ])->merge($server)->toArray();
-
-        $request = Request::create(
-            $uri, $method, $parameters,
-            $cookies, $files, $this->transformHeadersToServerVars($server), $content
-        );
-
-        $kernel = App::make('Illuminate\Contracts\Http\Kernel');
-        $response = $kernel->handle($request);
-
-        $kernel->terminate($request, $response);
-
-        return $response;
-    }
-}
diff --git a/src/Mpociot/ApiDoc/Parsers/RuleDescriptionParser.php b/src/Mpociot/ApiDoc/Parsers/RuleDescriptionParser.php
deleted file mode 100644
index 06aa335c..00000000
--- a/src/Mpociot/ApiDoc/Parsers/RuleDescriptionParser.php
+++ /dev/null
@@ -1,86 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Parsers;
-
-class RuleDescriptionParser
-{
-    private $rule;
-
-    private $parameters = [];
-
-    const DEFAULT_LOCALE = 'en';
-
-    /**
-     * @param null $rule
-     */
-    public function __construct($rule = null)
-    {
-        $this->rule = "apidoc::rules.{$rule}";
-    }
-
-    /**
-     * @return array|string
-     */
-    public function getDescription()
-    {
-        return $this->ruleDescriptionExist() ? $this->makeDescription() : [];
-    }
-
-    /**
-     * @param string|array $parameters
-     *
-     * @return $this
-     */
-    public function with($parameters)
-    {
-        is_array($parameters) ?
-            $this->parameters += $parameters :
-            $this->parameters[] = $parameters;
-
-        return $this;
-    }
-
-    /**
-     * @return bool
-     */
-    protected function ruleDescriptionExist()
-    {
-        return trans()->hasForLocale($this->rule) || trans()->hasForLocale($this->rule, self::DEFAULT_LOCALE);
-    }
-
-    /**
-     * @return string
-     */
-    protected function makeDescription()
-    {
-        $description = trans()->hasForLocale($this->rule) ?
-                            trans()->get($this->rule) :
-                            trans()->get($this->rule, [], self::DEFAULT_LOCALE);
-
-        return $this->replaceAttributes($description);
-    }
-
-    /**
-     * @param string $description$
-     *
-     * @return string
-     */
-    protected function replaceAttributes($description)
-    {
-        foreach ($this->parameters as $parameter) {
-            $description = preg_replace('/:attribute/', $parameter, $description, 1);
-        }
-
-        return $description;
-    }
-
-    /**
-     * @param null $rule
-     *
-     * @return static
-     */
-    public static function parse($rule = null)
-    {
-        return new static($rule);
-    }
-}
diff --git a/src/Mpociot/ApiDoc/Postman/CollectionWriter.php b/src/Mpociot/ApiDoc/Postman/CollectionWriter.php
deleted file mode 100644
index 6bf21865..00000000
--- a/src/Mpociot/ApiDoc/Postman/CollectionWriter.php
+++ /dev/null
@@ -1,67 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Postman;
-
-use Ramsey\Uuid\Uuid;
-use Illuminate\Support\Collection;
-
-class CollectionWriter
-{
-    /**
-     * @var Collection
-     */
-    private $routeGroups;
-
-    /**
-     * CollectionWriter constructor.
-     *
-     * @param Collection $routeGroups
-     */
-    public function __construct(Collection $routeGroups)
-    {
-        $this->routeGroups = $routeGroups;
-    }
-
-    public function getCollection()
-    {
-        $collection = [
-            'variables' => [],
-            'info' => [
-                'name' => '',
-                '_postman_id' => Uuid::uuid4()->toString(),
-                'description' => '',
-                'schema' => 'https://schema.getpostman.com/json/collection/v2.0.0/collection.json',
-            ],
-            'item' => $this->routeGroups->map(function ($routes, $groupName) {
-                return [
-                    'name' => $groupName,
-                    'description' => '',
-                    'item' => $routes->map(function ($route) {
-                        return [
-                            'name' => $route['title'] != '' ? $route['title'] : url(https://github.com/$route['uri']),
-                            'request' => [
-                                'url' => url(https://github.com/$route['uri']),
-                                'method' => $route['methods'][0],
-                                'body' => [
-                                    'mode' => 'formdata',
-                                    'formdata' => collect($route['parameters'])->map(function ($parameter, $key) {
-                                        return [
-                                            'key' => $key,
-                                            'value' => isset($parameter['value']) ? $parameter['value'] : '',
-                                            'type' => 'text',
-                                            'enabled' => true,
-                                        ];
-                                    })->values()->toArray(),
-                                ],
-                                'description' => $route['description'],
-                                'response' => [],
-                            ],
-                        ];
-                    })->toArray(),
-                ];
-            })->values()->toArray(),
-        ];
-
-        return json_encode($collection);
-    }
-}
diff --git a/src/Tools/DocumentationConfig.php b/src/Tools/DocumentationConfig.php
new file mode 100644
index 00000000..22b17d9b
--- /dev/null
+++ b/src/Tools/DocumentationConfig.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tools;
+
+class DocumentationConfig
+{
+    private $data;
+
+    public function __construct(array $config = [])
+    {
+        $this->data = $config;
+    }
+
+    public function get($key, $default = null)
+    {
+        return data_get($this->data, $key, $default);
+    }
+}
diff --git a/src/Tools/Flags.php b/src/Tools/Flags.php
new file mode 100644
index 00000000..00a80285
--- /dev/null
+++ b/src/Tools/Flags.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tools;
+
+class Flags
+{
+    public static $shouldBeVerbose = false;
+}
diff --git a/src/Tools/Utils.php b/src/Tools/Utils.php
new file mode 100644
index 00000000..8be7ecf7
--- /dev/null
+++ b/src/Tools/Utils.php
@@ -0,0 +1,174 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tools;
+
+use Illuminate\Routing\Route;
+use League\Flysystem\Adapter\Local;
+use League\Flysystem\Filesystem;
+use Symfony\Component\Console\Output\ConsoleOutput;
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\VarExporter\VarExporter;
+
+class Utils
+{
+    public static function getFullUrl(Route $route, array $urlParameters = []): string
+    {
+        $uri = $route->uri();
+
+        return self::replaceUrlParameterPlaceholdersWithValues($uri, $urlParameters);
+    }
+
+    /**
+     * @param array|Route $routeOrAction
+     *
+     * @return array|null
+     */
+    public static function getRouteClassAndMethodNames($routeOrAction)
+    {
+        $action = $routeOrAction instanceof Route ? $routeOrAction->getAction() : $routeOrAction;
+
+        if ($action['uses'] !== null) {
+            if (is_array($action['uses'])) {
+                return $action['uses'];
+            } elseif (is_string($action['uses'])) {
+                return explode('@', $action['uses']);
+            }
+        }
+        if (array_key_exists(0, $action) && array_key_exists(1, $action)) {
+            return [
+                0 => $action[0],
+                1 => $action[1],
+            ];
+        }
+    }
+
+    /**
+     * Transform parameters in URLs into real values (/users/{user} -> /users/2).
+     * Uses @urlParam values specified by caller, otherwise just uses '1'.
+     *
+     * @param string $uri
+     * @param array $urlParameters Dictionary of url params and example values
+     *
+     * @return mixed
+     */
+    public static function replaceUrlParameterPlaceholdersWithValues(string $uri, array $urlParameters)
+    {
+        $matches = preg_match_all('/{.+?}/i', $uri, $parameterPaths);
+        if (!$matches) {
+            return $uri;
+        }
+
+        foreach ($parameterPaths[0] as $parameterPath) {
+            $key = trim($parameterPath, '{?}');
+            if (isset($urlParameters[$key])) {
+                $example = $urlParameters[$key];
+                $uri = str_replace($parameterPath, $example, $uri);
+            }
+        }
+        // Remove unbound optional parameters with nothing
+        $uri = preg_replace('#{([^/]+\?)}#', '', $uri);
+        // Replace any unbound non-optional parameters with '1'
+        $uri = preg_replace('#{([^/]+)}#', '1', $uri);
+
+        return $uri;
+    }
+
+    public static function dumpException(\Exception $e)
+    {
+        if (class_exists(\NunoMaduro\Collision\Handler::class)) {
+            $output = new ConsoleOutput(OutputInterface::VERBOSITY_VERBOSE);
+            $handler = new \NunoMaduro\Collision\Handler(new \NunoMaduro\Collision\Writer($output));
+            $handler->setInspector(new \Whoops\Exception\Inspector($e));
+            $handler->setException($e);
+            $handler->handle();
+        } else {
+            dump($e);
+            echo "You can get better exception output by installing the library \nunomaduro/collision (PHP 7.1+ only).\n";
+        }
+    }
+
+    public static function deleteDirectoryAndContents($dir)
+    {
+        $dir = ltrim($dir, '/');
+        $adapter = new Local(realpath(__DIR__ . '/../../'));
+        $fs = new Filesystem($adapter);
+        $fs->deleteDir($dir);
+    }
+
+    /**
+     * @param mixed $value
+     * @param int $indentationLevel
+     *
+     * @return string
+     * @throws \Symfony\Component\VarExporter\Exception\ExceptionInterface
+     *
+     */
+    public static function printPhpValue($value, int $indentationLevel = 0): string
+    {
+        $output = VarExporter::export($value);
+        // Padding with x spaces so they align
+        $split = explode("\n", $output);
+        $result = '';
+        $padWith = str_repeat(' ', $indentationLevel);
+        foreach ($split as $index => $line) {
+            $result .= ($index == 0 ? '' : "\n$padWith") . $line;
+        }
+
+        return $result;
+    }
+
+    public static function printQueryParamsAsString(array $cleanQueryParams): string
+    {
+        $qs = '';
+        foreach ($cleanQueryParams as $parameter => $value) {
+            $paramName = urlencode($parameter);
+
+            if (!is_array($value)) {
+                $qs .= "$paramName=" . urlencode($value) . "&";
+            } else {
+                if (array_keys($value)[0] === 0) {
+                    // List query param (eg filter[]=haha should become "filter[]": "haha")
+                    $qs .= "$paramName" . '[]=' . urlencode($value[0]) . '&';
+                } else {
+                    // Hash query param (eg filter[name]=john should become "filter[name]": "john")
+                    foreach ($value as $item => $itemValue) {
+                        $qs .= "$paramName" . '[' . urlencode($item) . ']=' . urlencode($itemValue) . '&';
+                    }
+                }
+            }
+        }
+
+        return rtrim($qs, '&');
+    }
+
+    public static function printQueryParamsAsKeyValue(
+        array $cleanQueryParams,
+        string $quote = "\"",
+        string $delimiter = ":",
+        int $spacesIndentation = 4,
+        string $braces = "{}",
+        int $closingBraceIndentation = 0
+    ): string {
+        $output = "{$braces[0]}\n";
+        foreach ($cleanQueryParams as $parameter => $value) {
+            if (!is_array($value)) {
+                $output .= str_repeat(" ", $spacesIndentation);
+                $output .= "$quote$parameter$quote$delimiter $quote$value$quote,\n";
+            } else {
+                if (array_keys($value)[0] === 0) {
+                    // List query param (eg filter[]=haha should become "filter[]": "haha")
+                    $output .= str_repeat(" ", $spacesIndentation);
+                    $output .= "$quote$parameter" . "[]$quote$delimiter $quote$value[0]$quote,\n";
+                } else {
+                    // Hash query param (eg filter[name]=john should become "filter[name]": "john")
+                    foreach ($value as $item => $itemValue) {
+                        $output .= str_repeat(" ", $spacesIndentation);
+                        $output .= "$quote$parameter" . "[$item]$quote$delimiter $quote$itemValue$quote,\n";
+                    }
+                }
+            }
+        }
+
+        return $output . str_repeat(" ", $closingBraceIndentation) . "{$braces[1]}";
+    }
+}
diff --git a/src/Writing/PostmanCollectionWriter.php b/src/Writing/PostmanCollectionWriter.php
new file mode 100644
index 00000000..547cab77
--- /dev/null
+++ b/src/Writing/PostmanCollectionWriter.php
@@ -0,0 +1,198 @@
+<?php
+
+namespace Mpociot\ApiDoc\Writing;
+
+use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\URL;
+use Illuminate\Support\Str;
+use Ramsey\Uuid\Uuid;
+use ReflectionMethod;
+
+class PostmanCollectionWriter
+{
+    /**
+     * @var Collection
+     */
+    private $routeGroups;
+
+    /**
+     * @var string
+     */
+    private $baseUrl;
+
+    /**
+     * @var string
+     */
+    private $protocol;
+
+    /**
+     * @var array|null
+     */
+    private $auth;
+
+    /**
+     * CollectionWriter constructor.
+     *
+     * @param Collection $routeGroups
+     */
+    public function __construct(Collection $routeGroups, $baseUrl)
+    {
+        $this->routeGroups = $routeGroups;
+        $this->protocol = Str::startsWith($baseUrl, 'https') ? 'https' : 'http';
+        $this->baseUrl = $this->getBaseUrl($baseUrl);
+        $this->auth = config('apidoc.postman.auth');
+    }
+
+    public function getCollection()
+    {
+        $collection = [
+            'variables' => [],
+            'info' => [
+                'name' => config('apidoc.postman.name') ?: config('app.name') . ' API',
+                '_postman_id' => Uuid::uuid4()->toString(),
+                'description' => config('apidoc.postman.description') ?: '',
+                'schema' => 'https://schema.getpostman.com/json/collection/v2.0.0/collection.json',
+            ],
+            'item' => $this->routeGroups->map(function (Collection $routes, $groupName) {
+                return [
+                    'name' => $groupName,
+                    'description' => $routes->first()['metadata']['groupDescription'],
+                    'item' => $routes->map(\Closure::fromCallable([$this, 'generateEndpointItem']))->toArray(),
+                ];
+            })->values()->toArray(),
+        ];
+
+        if (! empty($this->auth)) {
+            $collection['auth'] = $this->auth;
+        }
+
+        return json_encode($collection, JSON_PRETTY_PRINT);
+    }
+
+    protected function generateEndpointItem($route)
+    {
+        $mode = 'raw';
+
+        $method = $route['methods'][0];
+
+        return [
+            'name' => $route['metadata']['title'] != '' ? $route['metadata']['title'] : $route['uri'],
+            'request' => [
+                'url' => $this->makeUrlData($route),
+                'method' => $method,
+                'header' => $this->resolveHeadersForRoute($route),
+                'body' => [
+                    'mode' => $mode,
+                    $mode => json_encode($route['cleanBodyParameters'], JSON_PRETTY_PRINT),
+                ],
+                'description' => $route['metadata']['description'] ?? null,
+                'response' => [],
+            ],
+        ];
+    }
+
+    protected function resolveHeadersForRoute($route)
+    {
+        $headers = collect($route['headers']);
+
+        // Exclude authentication headers if they're handled by Postman auth
+        $authHeader = $this->getAuthHeader();
+        if (! empty($authHeader)) {
+            $headers = $headers->except($authHeader);
+        }
+
+        return $headers
+            ->union([
+                'Accept' => 'application/json',
+            ])
+            ->map(function ($value, $header) {
+                return [
+                    'key' => $header,
+                    'value' => $value,
+                ];
+            })
+            ->values()
+            ->all();
+    }
+
+    protected function makeUrlData($route)
+    {
+        // URL Parameters are collected by the `UrlParameters` strategies, but only make sense if they're in the route
+        // definition. Filter out any URL parameters that don't appear in the URL.
+        $urlParams = collect($route['urlParameters'])->filter(function ($_, $key) use ($route) {
+            return Str::contains($route['uri'], '{' . $key . '}');
+        });
+
+        /** @var Collection $queryParams */
+        $base = [
+            'protocol' => $this->protocol,
+            'host' => $this->baseUrl,
+            // Substitute laravel/symfony query params ({example}) to Postman style, prefixed with a colon
+            'path' => preg_replace_callback('/\/{(\w+)\??}(?=\/|$)/', function ($matches) {
+                return '/:' . $matches[1];
+            }, $route['uri']),
+            'query' => collect($route['queryParameters'])->map(function ($parameter, $key) {
+                return [
+                    'key' => $key,
+                    'value' => urlencode($parameter['value']),
+                    'description' => $parameter['description'],
+                    // Default query params to disabled if they aren't required and have empty values
+                    'disabled' => ! $parameter['required'] && empty($parameter['value']),
+                ];
+            })->values()->toArray(),
+        ];
+
+        // If there aren't any url parameters described then return what we've got
+        /** @var $urlParams Collection */
+        if ($urlParams->isEmpty()) {
+            return $base;
+        }
+
+        $base['variable'] = $urlParams->map(function ($parameter, $key) {
+            return [
+                'id' => $key,
+                'key' => $key,
+                'value' => urlencode($parameter['value']),
+                'description' => $parameter['description'],
+            ];
+        })->values()->toArray();
+
+        return $base;
+    }
+
+    protected function getAuthHeader()
+    {
+        $auth = $this->auth;
+        if (empty($auth) || ! is_string($auth['type'] ?? null)) {
+            return null;
+        }
+
+        switch ($auth['type']) {
+            case 'bearer':
+                return 'Authorization';
+            case 'apikey':
+                $spec = $auth['apikey'];
+
+                if (isset($spec['in']) && $spec['in'] !== 'header') {
+                    return null;
+                }
+
+                return $spec['key'];
+            default:
+                return null;
+        }
+    }
+
+    protected function getBaseUrl($baseUrl)
+    {
+        if (Str::contains(app()->version(), 'Lumen')) { //Is Lumen
+            $reflectionMethod = new ReflectionMethod(\Laravel\Lumen\Routing\UrlGenerator::class, 'getRootUrl');
+            $reflectionMethod->setAccessible(true);
+            $url = app('url');
+
+            return $reflectionMethod->invokeArgs($url, ['', $baseUrl]);
+        }
+
+        return URL::formatRoot('', $baseUrl);
+    }
+}
diff --git a/src/Writing/Writer.php b/src/Writing/Writer.php
new file mode 100644
index 00000000..4c03f2f7
--- /dev/null
+++ b/src/Writing/Writer.php
@@ -0,0 +1,309 @@
+<?php
+
+namespace Mpociot\ApiDoc\Writing;
+
+use Illuminate\Console\Command;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\Storage;
+use Mpociot\ApiDoc\Tools\DocumentationConfig;
+use Mpociot\Documentarian\Documentarian;
+
+class Writer
+{
+    /**
+     * @var Command
+     */
+    protected $output;
+
+    /**
+     * @var DocumentationConfig
+     */
+    private $config;
+
+    /**
+     * @var string
+     */
+    private $baseUrl;
+
+    /**
+     * @var bool
+     */
+    private $forceIt;
+
+    /**
+     * @var bool
+     */
+    private $shouldGeneratePostmanCollection = true;
+
+    /**
+     * @var Documentarian
+     */
+    private $documentarian;
+
+    /**
+     * @var bool
+     */
+    private $isStatic;
+
+    /**
+     * @var string
+     */
+    private $sourceOutputPath;
+
+    /**
+     * @var string
+     */
+    private $outputPath;
+
+    public function __construct(Command $output, DocumentationConfig $config = null, bool $forceIt = false)
+    {
+        // If no config is injected, pull from global
+        $this->config = $config ?: new DocumentationConfig(config('apidoc'));
+        $this->baseUrl = $this->config->get('base_url') ?? config('app.url');
+        $this->forceIt = $forceIt;
+        $this->output = $output;
+        $this->shouldGeneratePostmanCollection = $this->config->get('postman.enabled', false);
+        $this->documentarian = new Documentarian();
+        $this->isStatic = $this->config->get('type') === 'static';
+        $this->sourceOutputPath = 'resources/docs';
+        $this->outputPath = $this->isStatic ? ($this->config->get('output_folder') ?? 'public/docs') : 'resources/views/apidoc';
+    }
+
+    public function writeDocs(Collection $routes)
+    {
+        // The source files (index.md, js/, css/, and images/) always go in resources/docs/source.
+        // The static assets (js/, css/, and images/) always go in public/docs/.
+        // For 'static' docs, the output files (index.html, collection.json) go in public/docs/.
+        // For 'laravel' docs, the output files (index.blade.php, collection.json)
+        // go in resources/views/apidoc/ and storage/app/apidoc/ respectively.
+
+        $this->writeMarkdownAndSourceFiles($routes);
+
+        $this->writeHtmlDocs();
+
+        $this->writePostmanCollection($routes);
+    }
+
+    /**
+     * @param  Collection $parsedRoutes
+     *
+     * @return void
+     */
+    public function writeMarkdownAndSourceFiles(Collection $parsedRoutes)
+    {
+        $targetFile = $this->sourceOutputPath . '/source/index.md';
+        $compareFile = $this->sourceOutputPath . '/source/.compare.md';
+
+        $infoText = view('apidoc::partials.info')
+            ->with('outputPath', 'docs')
+            ->with('showPostmanCollectionButton', $this->shouldGeneratePostmanCollection);
+
+        $settings = ['languages' => $this->config->get('example_languages')];
+        // Generate Markdown for each route
+        $parsedRouteOutput = $this->generateMarkdownOutputForEachRoute($parsedRoutes, $settings);
+
+        $frontmatter = view('apidoc::partials.frontmatter')
+            ->with('settings', $settings);
+
+        /*
+         * If the target file already exists,
+         * we check if the documentation was modified
+         * and skip the modified parts of the routes.
+         */
+        if (file_exists($targetFile) && file_exists($compareFile)) {
+            $generatedDocumentation = file_get_contents($targetFile);
+            $compareDocumentation = file_get_contents($compareFile);
+
+            $parsedRouteOutput->transform(function (Collection $routeGroup) use ($generatedDocumentation, $compareDocumentation) {
+                return $routeGroup->transform(function (array $route) use ($generatedDocumentation, $compareDocumentation) {
+                    if (preg_match('/<!-- START_' . $route['id'] . ' -->(.*)<!-- END_' . $route['id'] . ' -->/is', $generatedDocumentation, $existingRouteDoc)) {
+                        $routeDocumentationChanged = (preg_match('/<!-- START_' . $route['id'] . ' -->(.*)<!-- END_' . $route['id'] . ' -->/is', $compareDocumentation, $lastDocWeGeneratedForThisRoute) && $lastDocWeGeneratedForThisRoute[1] !== $existingRouteDoc[1]);
+                        if ($routeDocumentationChanged === false || $this->forceIt) {
+                            if ($routeDocumentationChanged) {
+                                $this->output->warn('Discarded manual changes for route [' . implode(',', $route['methods']) . '] ' . $route['uri']);
+                            }
+                        } else {
+                            $this->output->warn('Skipping modified route [' . implode(',', $route['methods']) . '] ' . $route['uri']);
+                            $route['modified_output'] = $existingRouteDoc[0];
+                        }
+                    }
+
+                    return $route;
+                });
+            });
+        }
+
+        $prependFileContents = $this->getMarkdownToPrepend();
+        $appendFileContents = $this->getMarkdownToAppend();
+
+        $markdown = view('apidoc::documentarian')
+            ->with('writeCompareFile', false)
+            ->with('frontmatter', $frontmatter)
+            ->with('infoText', $infoText)
+            ->with('prependMd', $prependFileContents)
+            ->with('appendMd', $appendFileContents)
+            ->with('outputPath', $this->config->get('output'))
+            ->with('showPostmanCollectionButton', $this->shouldGeneratePostmanCollection)
+            ->with('parsedRoutes', $parsedRouteOutput);
+
+        $this->output->info('Writing index.md and source files to: ' . $this->sourceOutputPath);
+
+        if (! is_dir($this->sourceOutputPath)) {
+            $documentarian = new Documentarian();
+            $documentarian->create($this->sourceOutputPath);
+        }
+
+        // Write output file
+        file_put_contents($targetFile, $markdown);
+
+        // Write comparable markdown file
+        $compareMarkdown = view('apidoc::documentarian')
+            ->with('writeCompareFile', true)
+            ->with('frontmatter', $frontmatter)
+            ->with('infoText', $infoText)
+            ->with('prependMd', $prependFileContents)
+            ->with('appendMd', $appendFileContents)
+            ->with('outputPath', $this->config->get('output'))
+            ->with('showPostmanCollectionButton', $this->shouldGeneratePostmanCollection)
+            ->with('parsedRoutes', $parsedRouteOutput);
+
+        file_put_contents($compareFile, $compareMarkdown);
+
+        $this->output->info('Wrote index.md and source files to: ' . $this->sourceOutputPath);
+    }
+
+    public function generateMarkdownOutputForEachRoute(Collection $parsedRoutes, array $settings): Collection
+    {
+        $parsedRouteOutput = $parsedRoutes->map(function (Collection $routeGroup) use ($settings) {
+            return $routeGroup->map(function (array $route) use ($settings) {
+                if (count($route['cleanBodyParameters']) && ! isset($route['headers']['Content-Type'])) {
+                    // Set content type if the user forgot to set it
+                    $route['headers']['Content-Type'] = 'application/json';
+                }
+
+                $hasRequestOptions = ! empty($route['headers']) || ! empty($route['cleanQueryParameters']) || ! empty($route['cleanBodyParameters']);
+                $route['output'] = (string) view('apidoc::partials.route')
+                    ->with('hasRequestOptions', $hasRequestOptions)
+                    ->with('route', $route)
+                    ->with('settings', $settings)
+                    ->with('baseUrl', $this->baseUrl)
+                    ->render();
+
+                return $route;
+            });
+        });
+
+        return $parsedRouteOutput;
+    }
+
+    protected function writePostmanCollection(Collection $parsedRoutes): void
+    {
+        if ($this->shouldGeneratePostmanCollection) {
+            $this->output->info('Generating Postman collection');
+
+            $collection = $this->generatePostmanCollection($parsedRoutes);
+            if ($this->isStatic) {
+                $collectionPath = "{$this->outputPath}/collection.json";
+                file_put_contents($collectionPath, $collection);
+            } else {
+                $storageInstance = Storage::disk($this->config->get('storage'));
+                $storageInstance->put('apidoc/collection.json', $collection, 'public');
+                if ($this->config->get('storage') == 'local') {
+                    $collectionPath = 'storage/app/apidoc/collection.json';
+                } else {
+                    $collectionPath = $storageInstance->url('https://github.com/collection.json');
+                }
+            }
+
+            $this->output->info("Wrote Postman collection to: {$collectionPath}");
+        }
+    }
+
+    /**
+     * Generate Postman collection JSON file.
+     *
+     * @param Collection $routes
+     *
+     * @return string
+     */
+    public function generatePostmanCollection(Collection $routes)
+    {
+        /** @var PostmanCollectionWriter $writer */
+        $writer = app()->makeWith(
+            PostmanCollectionWriter::class,
+            ['routeGroups' => $routes, 'baseUrl' => $this->baseUrl]
+        );
+
+        return $writer->getCollection();
+    }
+
+    protected function getMarkdownToPrepend(): string
+    {
+        $prependFile = $this->sourceOutputPath . '/source/prepend.md';
+        $prependFileContents = file_exists($prependFile)
+            ? file_get_contents($prependFile) . "\n" : '';
+
+        return $prependFileContents;
+    }
+
+    protected function getMarkdownToAppend(): string
+    {
+        $appendFile = $this->sourceOutputPath . '/source/append.md';
+        $appendFileContents = file_exists($appendFile)
+            ? "\n" . file_get_contents($appendFile) : '';
+
+        return $appendFileContents;
+    }
+
+    protected function copyAssetsFromSourceFolderToPublicFolder(): void
+    {
+        $publicPath = $this->config->get('output_folder') ?? 'public/docs';
+        if (! is_dir($publicPath)) {
+            mkdir($publicPath, 0777, true);
+            mkdir("{$publicPath}/css");
+            mkdir("{$publicPath}/js");
+        }
+        copy("{$this->sourceOutputPath}/js/all.js", "{$publicPath}/js/all.js");
+        rcopy("{$this->sourceOutputPath}/images", "{$publicPath}/images");
+        rcopy("{$this->sourceOutputPath}/css", "{$publicPath}/css");
+
+        if ($logo = $this->config->get('logo')) {
+            copy($logo, "{$publicPath}/images/logo.png");
+        }
+    }
+
+    protected function moveOutputFromSourceFolderToTargetFolder(): void
+    {
+        if ($this->isStatic) {
+            // Move output (index.html, css/style.css and js/all.js) to public/docs
+            rename("{$this->sourceOutputPath}/index.html", "{$this->outputPath}/index.html");
+        } else {
+            // Move output to resources/views
+            if (! is_dir($this->outputPath)) {
+                mkdir($this->outputPath);
+            }
+            rename("{$this->sourceOutputPath}/index.html", "$this->outputPath/index.blade.php");
+            $contents = file_get_contents("$this->outputPath/index.blade.php");
+            //
+            $contents = str_replace('href="https://github.com/css/style.css"', 'href="https://github.com/%7B%7B%20asset(/'/docs/css/style.css\') }}"', $contents);
+            $contents = str_replace('src="https://github.com/js/all.js"', 'src="https://github.com/%7B%7B%20asset(/'/docs/js/all.js\') }}"', $contents);
+            $contents = str_replace('src="https://github.com/images/', 'src="https://github.com/docs/images/', $contents);
+            $contents = preg_replace('#href="https://github.com/https?://.+?/docs/collection.json"#', 'href="https://github.com/%7B%7B%20route("apidoc.json") }}"', $contents);
+            file_put_contents("$this->outputPath/index.blade.php", $contents);
+        }
+    }
+
+    public function writeHtmlDocs(): void
+    {
+        $this->output->info('Generating API HTML code');
+
+        $this->documentarian->generate($this->sourceOutputPath);
+
+        // Move assets to public folder
+        $this->copyAssetsFromSourceFolderToPublicFolder();
+
+        $this->moveOutputFromSourceFolderToTargetFolder();
+
+        $this->output->info("Wrote HTML documentation to: {$this->outputPath}");
+    }
+}
diff --git a/src/resources/lang/en/rules.php b/src/resources/lang/en/rules.php
deleted file mode 100644
index 5bab0bf7..00000000
--- a/src/resources/lang/en/rules.php
+++ /dev/null
@@ -1,35 +0,0 @@
-<?php
-
-return [
-    'after' => 'Must be a date after: `:attribute`',
-    'alpha' => 'Only alphabetic characters allowed',
-    'alpha_dash' => 'Allowed: alpha-numeric characters, as well as dashes and underscores.',
-    'alpha_num' => 'Only alpha-numeric characters allowed',
-    'array' => 'Must be an array',
-    'in' => ':attribute',
-    'not_in' => 'Not in: :attribute',
-    'min' => 'Minimum: `:attribute`',
-    'max' => 'Maximum: `:attribute`',
-    'between' => 'Between: `:attribute` and `:attribute`',
-    'before' => 'Must be a date preceding: `:attribute`',
-    'date_format' => 'Date format: `:attribute`',
-    'different' => 'Must have a different value than parameter: `:attribute`',
-    'digits' => 'Must have an exact length of `:attribute`',
-    'digits_between' => 'Must have a length between `:attribute` and `:attribute`',
-    'file' => 'Must be a file upload',
-    'image' => 'Must be an image (jpeg, png, bmp, gif, or svg)',
-    'json' => 'Must be a valid JSON string.',
-    'mimetypes' => 'Allowed mime types: :attribute',
-    'mimes' => 'Allowed mime types: :attribute',
-    'required_if' => 'Required if :attribute',
-    'required_unless' => 'Required unless :attribute',
-    'required_with' => 'Required if the parameters :attribute are present.',
-    'required_with_all' => 'Required if the parameters :attribute are present.',
-    'required_without' => 'Required if the parameters :attribute are not present.',
-    'required_without_all' => 'Required if the parameters :attribute are not present.',
-    'same' => 'Must be the same as `:attribute`',
-    'size' => 'Must have the size of `:attribute`',
-    'timezone' => 'Must be a valid timezone identifier',
-    'exists' => 'Valid :attribute :attribute',
-    'regex' => 'Must match this regular expression: `:attribute`',
-];
diff --git a/src/resources/views/partials/route.blade.php b/src/resources/views/partials/route.blade.php
deleted file mode 100644
index 02e340a6..00000000
--- a/src/resources/views/partials/route.blade.php
+++ /dev/null
@@ -1,69 +0,0 @@
-<!-- START_{{$parsedRoute['id']}} -->
-@if($parsedRoute['title'] != '')## {{ $parsedRoute['title']}}
-@else## {{$parsedRoute['uri']}}
-@endif
-@if($parsedRoute['description'])
-
-{!! $parsedRoute['description'] !!}
-@endif
-
-> Example request:
-
-```bash
-curl -X {{$parsedRoute['methods'][0]}} {{$parsedRoute['methods'][0] == 'GET' ? '-G ' : ''}}"{{ trim(config('app.docs_url') ?: config('app.url'), '/')}}/{{ ltrim($parsedRoute['uri'], '/') }}" \
-    -H "Accept: application/json"@if(count($parsedRoute['parameters'])) \
-@foreach($parsedRoute['parameters'] as $attribute => $parameter)
-    -d "{{$attribute}}"="{{$parameter['value']}}" @if(! ($loop->last))\
-    @endif
-@endforeach
-@endif
-
-```
-
-```javascript
-var settings = {
-    "async": true,
-    "crossDomain": true,
-    "url": "{{ rtrim(config('app.docs_url') ?: config('app.url'), '/') }}/{{ ltrim($parsedRoute['uri'], '/') }}",
-    "method": "{{$parsedRoute['methods'][0]}}",
-    @if(count($parsedRoute['parameters']))
-"data": {!! str_replace("\n}","\n    }", str_replace('    ','        ',json_encode(array_combine(array_keys($parsedRoute['parameters']), array_map(function($param){ return $param['value']; },$parsedRoute['parameters'])), JSON_PRETTY_PRINT))) !!},
-    @endif
-"headers": {
-        "accept": "application/json"
-    }
-}
-
-$.ajax(settings).done(function (response) {
-    console.log(response);
-});
-```
-
-@if(in_array('GET',$parsedRoute['methods']) || (isset($parsedRoute['showresponse']) && $parsedRoute['showresponse']))
-> Example response:
-
-```json
-@if(is_object($parsedRoute['response']) || is_array($parsedRoute['response']))
-{!! json_encode($parsedRoute['response'], JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) !!}
-@else
-{!! json_encode(json_decode($parsedRoute['response']), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) !!}
-@endif
-```
-@endif
-
-### HTTP Request
-@foreach($parsedRoute['methods'] as $method)
-`{{$method}} {{$parsedRoute['uri']}}`
-
-@endforeach
-@if(count($parsedRoute['parameters']))
-#### Parameters
-
-Parameter | Type | Status | Description
---------- | ------- | ------- | ------- | -----------
-@foreach($parsedRoute['parameters'] as $attribute => $parameter)
-    {{$attribute}} | {{$parameter['type']}} | @if($parameter['required']) required @else optional @endif | {!! implode(' ',$parameter['description']) !!}
-@endforeach
-@endif
-
-<!-- END_{{$parsedRoute['id']}} -->
diff --git a/tests/ApiDocGeneratorTest.php b/tests/ApiDocGeneratorTest.php
deleted file mode 100644
index b3407514..00000000
--- a/tests/ApiDocGeneratorTest.php
+++ /dev/null
@@ -1,424 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Tests;
-
-use Illuminate\Routing\Route;
-use Orchestra\Testbench\TestCase;
-use Mpociot\ApiDoc\Tests\Fixtures\TestRequest;
-use Mpociot\ApiDoc\Generators\LaravelGenerator;
-use Mpociot\ApiDoc\Tests\Fixtures\TestController;
-use Mpociot\ApiDoc\ApiDocGeneratorServiceProvider;
-use Illuminate\Support\Facades\Route as RouteFacade;
-
-class ApiDocGeneratorTest extends TestCase
-{
-    /**
-     * @var \Mpociot\ApiDoc\AbstractGenerator
-     */
-    protected $generator;
-
-    protected function getPackageProviders($app)
-    {
-        return [
-            ApiDocGeneratorServiceProvider::class,
-        ];
-    }
-
-    /**
-     * Setup the test environment.
-     */
-    public function setUp()
-    {
-        parent::setUp();
-
-        $this->generator = new LaravelGenerator();
-    }
-
-    public function testCanParseMethodDescription()
-    {
-        RouteFacade::get('/api/test', TestController::class.'@parseMethodDescription');
-        $route = new Route(['GET'], '/api/test', ['uses' => TestController::class.'@parseMethodDescription']);
-        $parsed = $this->generator->processRoute($route);
-
-        $this->assertSame('Example title.', $parsed['title']);
-        $this->assertSame("This will be the long description.\nIt can also be multiple lines long.", $parsed['description']);
-    }
-
-    public function testCanParseRouteMethods()
-    {
-        RouteFacade::get('/get', TestController::class.'@dummy');
-        RouteFacade::post('/post', TestController::class.'@dummy');
-        RouteFacade::put('/put', TestController::class.'@dummy');
-        RouteFacade::delete('/delete', TestController::class.'@dummy');
-
-        $route = new Route(['GET'], '/get', ['uses' => TestController::class.'@parseMethodDescription']);
-        $parsed = $this->generator->processRoute($route);
-        $this->assertSame(['GET'], $parsed['methods']);
-
-        $route = new Route(['POST'], '/post', ['uses' => TestController::class.'@parseMethodDescription']);
-        $parsed = $this->generator->processRoute($route);
-        $this->assertSame(['POST'], $parsed['methods']);
-
-        $route = new Route(['PUT'], '/put', ['uses' => TestController::class.'@parseMethodDescription']);
-        $parsed = $this->generator->processRoute($route);
-        $this->assertSame(['PUT'], $parsed['methods']);
-
-        $route = new Route(['DELETE'], '/delete', ['uses' => TestController::class.'@parseMethodDescription']);
-        $parsed = $this->generator->processRoute($route);
-        $this->assertSame(['DELETE'], $parsed['methods']);
-    }
-
-    public function testCanParseDependencyInjectionInControllerMethods()
-    {
-        RouteFacade::post('/post', TestController::class.'@dependencyInjection');
-        $route = new Route(['POST'], '/post', ['uses' => TestController::class.'@dependencyInjection']);
-        $parsed = $this->generator->processRoute($route);
-        $this->assertTrue(is_array($parsed));
-    }
-
-    public function testCanParseFormRequestRules()
-    {
-        RouteFacade::post('/post', TestController::class.'@parseFormRequestRules');
-        $route = new Route(['POST'], '/post', ['uses' => TestController::class.'@parseFormRequestRules']);
-        $parsed = $this->generator->processRoute($route);
-        $parameters = $parsed['parameters'];
-
-        $testRequest = new TestRequest();
-        $rules = $testRequest->rules();
-
-        foreach ($rules as $name => $rule) {
-            $attribute = $parameters[$name];
-
-            switch ($name) {
-
-                case 'required':
-                    $this->assertTrue($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'accepted':
-                    $this->assertTrue($attribute['required']);
-                    $this->assertSame('boolean', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'active_url':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('url', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'alpha':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Only alphabetic characters allowed', $attribute['description'][0]);
-                    break;
-                case 'alpha_dash':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Allowed: alpha-numeric characters, as well as dashes and underscores.', $attribute['description'][0]);
-                    break;
-                case 'alpha_num':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Only alpha-numeric characters allowed', $attribute['description'][0]);
-                    break;
-                case 'array':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('array', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    break;
-                case 'between':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('numeric', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Between: `5` and `200`', $attribute['description'][0]);
-                    break;
-                case 'string_between':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Between: `5` and `200`', $attribute['description'][0]);
-                    break;
-                case 'before':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('date', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must be a date preceding: `Saturday, 23-Apr-16 14:31:00 UTC`', $attribute['description'][0]);
-                    break;
-                case 'boolean':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('boolean', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'date':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('date', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'date_format':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('date', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Date format: `j.n.Y H:iP`', $attribute['description'][0]);
-                    break;
-                case 'different':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must have a different value than parameter: `alpha_num`', $attribute['description'][0]);
-                    break;
-                case 'digits':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('numeric', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must have an exact length of `2`', $attribute['description'][0]);
-                    break;
-                case 'digits_between':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('numeric', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must have a length between `2` and `10`', $attribute['description'][0]);
-                    break;
-                case 'email':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('email', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'exists':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Valid user firstname', $attribute['description'][0]);
-                    break;
-                case 'single_exists':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Valid user single_exists', $attribute['description'][0]);
-                    break;
-                case 'file':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('file', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must be a file upload', $attribute['description'][0]);
-                    break;
-                case 'image':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('image', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must be an image (jpeg, png, bmp, gif, or svg)', $attribute['description'][0]);
-                    break;
-                case 'in':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('`jpeg`, `png`, `bmp`, `gif` or `svg`', $attribute['description'][0]);
-                    break;
-                case 'integer':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('integer', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'ip':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('ip', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'json':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must be a valid JSON string.', $attribute['description'][0]);
-                    break;
-                case 'max':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Maximum: `10`', $attribute['description'][0]);
-                    break;
-                case 'min':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Minimum: `20`', $attribute['description'][0]);
-                    break;
-                case 'mimes':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Allowed mime types: `jpeg`, `bmp` or `png`', $attribute['description'][0]);
-                    break;
-                case 'not_in':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Not in: `foo` or `bar`', $attribute['description'][0]);
-                    break;
-                case 'numeric':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('numeric', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'regex':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must match this regular expression: `(.*)`', $attribute['description'][0]);
-                    break;
-                case 'multiple_required_if':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required if `foo` is `bar` or `baz` is `qux`', $attribute['description'][0]);
-                    break;
-                case 'required_if':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required if `foo` is `bar`', $attribute['description'][0]);
-                    break;
-                case 'required_unless':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required unless `foo` is `bar`', $attribute['description'][0]);
-                    break;
-                case 'required_with':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required if the parameters `foo`, `bar` or `baz` are present.', $attribute['description'][0]);
-                    break;
-                case 'required_with_all':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required if the parameters `foo`, `bar` and `baz` are present.', $attribute['description'][0]);
-                    break;
-                case 'required_without':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required if the parameters `foo`, `bar` or `baz` are not present.', $attribute['description'][0]);
-                    break;
-                case 'required_without_all':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required if the parameters `foo`, `bar` and `baz` are not present.', $attribute['description'][0]);
-                    break;
-                case 'same':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must be the same as `foo`', $attribute['description'][0]);
-                    break;
-                case 'size':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must have the size of `51`', $attribute['description'][0]);
-                    break;
-                case 'timezone':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must be a valid timezone identifier', $attribute['description'][0]);
-                    break;
-                case 'url':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('url', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-
-            }
-        }
-    }
-
-    public function testCustomFormRequestValidatorIsSupported()
-    {
-        RouteFacade::post('/post', TestController::class.'@customFormRequestValidator');
-        $route = new Route(['POST'], '/post', ['uses' => TestController::class.'@customFormRequestValidator']);
-        $parsed = $this->generator->processRoute($route);
-        $parameters = $parsed['parameters'];
-
-        $this->assertNotEmpty($parameters);
-    }
-
-    public function testCanParseResponseTag()
-    {
-        RouteFacade::post('/responseTag', TestController::class.'@responseTag');
-        $route = new Route(['POST'], '/responseTag', ['uses' => TestController::class.'@responseTag']);
-        $parsed = $this->generator->processRoute($route);
-        $this->assertTrue(is_array($parsed));
-        $this->assertArrayHasKey('showresponse', $parsed);
-        $this->assertTrue($parsed['showresponse']);
-        $this->assertJsonStringEqualsJsonString($parsed['response'], '{ "data": []}');
-    }
-
-    public function testCanParseTransformerTag()
-    {
-        if (version_compare(PHP_VERSION, '7.0.0', '<')) {
-            $this->markTestSkipped('The transformer tag without model need PHP 7');
-        }
-        RouteFacade::post('/transformerTag', TestController::class.'@transformerTag');
-        $route = new Route(['GET'], '/transformerTag', ['uses' => TestController::class.'@transformerTag']);
-        $parsed = $this->generator->processRoute($route);
-        $this->assertTrue(is_array($parsed));
-        $this->assertArrayHasKey('showresponse', $parsed);
-        $this->assertTrue($parsed['showresponse']);
-        $this->assertSame(
-            $parsed['response'],
-            '{"data":{"id":1,"description":"Welcome on this test versions","name":"TestName"}}'
-        );
-    }
-
-    public function testCanParseTransformerTagWithModel()
-    {
-        RouteFacade::post('/transformerTagWithModel', TestController::class.'@transformerTagWithModel');
-        $route = new Route(['GET'], '/transformerTagWithModel', ['uses' => TestController::class.'@transformerTagWithModel']);
-        $parsed = $this->generator->processRoute($route);
-        $this->assertTrue(is_array($parsed));
-        $this->assertArrayHasKey('showresponse', $parsed);
-        $this->assertTrue($parsed['showresponse']);
-        $this->assertSame(
-            $parsed['response'],
-            '{"data":{"id":1,"description":"Welcome on this test versions","name":"TestName"}}'
-        );
-    }
-
-    public function testCanParseTransformerCollectionTag()
-    {
-        if (version_compare(PHP_VERSION, '7.0.0', '<')) {
-            $this->markTestSkipped('The transformer tag without model need PHP 7');
-        }
-        RouteFacade::post('/transformerCollectionTag', TestController::class.'@transformerCollectionTag');
-        $route = new Route(['GET'], '/transformerCollectionTag', ['uses' => TestController::class.'@transformerCollectionTag']);
-        $parsed = $this->generator->processRoute($route);
-        $this->assertTrue(is_array($parsed));
-        $this->assertArrayHasKey('showresponse', $parsed);
-        $this->assertTrue($parsed['showresponse']);
-        $this->assertSame(
-            $parsed['response'],
-            '{"data":[{"id":1,"description":"Welcome on this test versions","name":"TestName"},'.
-            '{"id":1,"description":"Welcome on this test versions","name":"TestName"}]}'
-        );
-    }
-
-    public function testCanParseTransformerCollectionTagWithModel()
-    {
-        RouteFacade::post('/transformerCollectionTagWithModel', TestController::class.'@transformerCollectionTagWithModel');
-        $route = new Route(['GET'], '/transformerCollectionTagWithModel', ['uses' => TestController::class.'@transformerCollectionTagWithModel']);
-        $parsed = $this->generator->processRoute($route);
-        $this->assertTrue(is_array($parsed));
-        $this->assertArrayHasKey('showresponse', $parsed);
-        $this->assertTrue($parsed['showresponse']);
-        $this->assertSame(
-            $parsed['response'],
-            '{"data":[{"id":1,"description":"Welcome on this test versions","name":"TestName"},'.
-            '{"id":1,"description":"Welcome on this test versions","name":"TestName"}]}'
-        );
-    }
-}
diff --git a/tests/DingoGeneratorTest.php b/tests/DingoGeneratorTest.php
deleted file mode 100644
index 2311498d..00000000
--- a/tests/DingoGeneratorTest.php
+++ /dev/null
@@ -1,354 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Tests;
-
-use Orchestra\Testbench\TestCase;
-use Mpociot\ApiDoc\Generators\DingoGenerator;
-use Dingo\Api\Provider\LaravelServiceProvider;
-use Mpociot\ApiDoc\Tests\Fixtures\TestRequest;
-use Mpociot\ApiDoc\Tests\Fixtures\TestController;
-use Mpociot\ApiDoc\ApiDocGeneratorServiceProvider;
-use Mpociot\ApiDoc\Tests\Fixtures\DingoTestController;
-
-class DingoGeneratorTest extends TestCase
-{
-    /**
-     * @var \Mpociot\ApiDoc\Generators\DingoGenerator
-     */
-    protected $generator;
-
-    protected function getPackageProviders($app)
-    {
-        return [
-            LaravelServiceProvider::class,
-            ApiDocGeneratorServiceProvider::class,
-        ];
-    }
-
-    /**
-     * Setup the test environment.
-     */
-    public function setUp()
-    {
-        parent::setUp();
-
-        $this->generator = new DingoGenerator();
-    }
-
-    public function testCanParseMethodDescription()
-    {
-        if (version_compare($this->app->version(), '5.4', '>=')) {
-            $this->markTestSkipped('Dingo does not support Laravel 5.4');
-        }
-
-        $api = app('Dingo\Api\Routing\Router');
-        $api->version('v1', function ($api) {
-            $api->get('/api/test', TestController::class.'@parseMethodDescription');
-        });
-        $route = app('Dingo\Api\Routing\Router')->getRoutes()['v1']->getRoutes()[0];
-
-        $parsed = $this->generator->processRoute($route);
-
-        $this->assertSame('Example title.', $parsed['title']);
-        $this->assertSame("This will be the long description.\nIt can also be multiple lines long.", $parsed['description']);
-    }
-
-    public function testCanParseRouteMethods()
-    {
-        if (version_compare($this->app->version(), '5.4', '>=')) {
-            $this->markTestSkipped('Dingo does not support Laravel 5.4');
-        }
-
-        $api = app('Dingo\Api\Routing\Router');
-        $api->version('v1', function ($api) {
-            $api->get('/get', TestController::class.'@dummy');
-            $api->post('/post', TestController::class.'@dummy');
-            $api->put('/put', TestController::class.'@dummy');
-            $api->delete('/delete', TestController::class.'@dummy');
-        });
-        $route = app('Dingo\Api\Routing\Router')->getRoutes()['v1']->getRoutes()[0];
-        $parsed = $this->generator->processRoute($route);
-        $this->assertSame(['GET'], $parsed['methods']);
-
-        $route = app('Dingo\Api\Routing\Router')->getRoutes()['v1']->getRoutes()[1];
-        $parsed = $this->generator->processRoute($route);
-        $this->assertSame(['POST'], $parsed['methods']);
-
-        $route = app('Dingo\Api\Routing\Router')->getRoutes()['v1']->getRoutes()[2];
-        $parsed = $this->generator->processRoute($route);
-        $this->assertSame(['PUT'], $parsed['methods']);
-
-        $route = app('Dingo\Api\Routing\Router')->getRoutes()['v1']->getRoutes()[3];
-        $parsed = $this->generator->processRoute($route);
-        $this->assertSame(['DELETE'], $parsed['methods']);
-    }
-
-    public function testCanParseFormRequestRules()
-    {
-        if (version_compare($this->app->version(), '5.4', '>=')) {
-            $this->markTestSkipped('Dingo does not support Laravel 5.4');
-        }
-
-        $api = app('Dingo\Api\Routing\Router');
-        $api->version('v1', function ($api) {
-            $api->post('/post', DingoTestController::class.'@parseFormRequestRules');
-        });
-
-        $route = app('Dingo\Api\Routing\Router')->getRoutes()['v1']->getRoutes()[0];
-        $parsed = $this->generator->processRoute($route);
-        $parameters = $parsed['parameters'];
-
-        $testRequest = new TestRequest();
-        $rules = $testRequest->rules();
-
-        foreach ($rules as $name => $rule) {
-            $attribute = $parameters[$name];
-
-            switch ($name) {
-
-                case 'required':
-                    $this->assertTrue($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'accepted':
-                    $this->assertTrue($attribute['required']);
-                    $this->assertSame('boolean', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'active_url':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('url', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'alpha':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Only alphabetic characters allowed', $attribute['description'][0]);
-                    break;
-                case 'alpha_dash':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Allowed: alpha-numeric characters, as well as dashes and underscores.', $attribute['description'][0]);
-                    break;
-                case 'alpha_num':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Only alpha-numeric characters allowed', $attribute['description'][0]);
-                    break;
-                case 'array':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('array', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'between':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('numeric', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Between: `5` and `200`', $attribute['description'][0]);
-                    break;
-                case 'string_between':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Between: `5` and `200`', $attribute['description'][0]);
-                    break;
-                case 'before':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('date', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must be a date preceding: `Saturday, 23-Apr-16 14:31:00 UTC`', $attribute['description'][0]);
-                    break;
-                case 'boolean':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('boolean', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'date':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('date', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'date_format':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('date', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Date format: `j.n.Y H:iP`', $attribute['description'][0]);
-                    break;
-                case 'different':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must have a different value than parameter: `alpha_num`', $attribute['description'][0]);
-                    break;
-                case 'digits':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('numeric', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must have an exact length of `2`', $attribute['description'][0]);
-                    break;
-                case 'digits_between':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('numeric', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must have a length between `2` and `10`', $attribute['description'][0]);
-                    break;
-                case 'email':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('email', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'exists':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Valid user firstname', $attribute['description'][0]);
-                    break;
-                case 'single_exists':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Valid user single_exists', $attribute['description'][0]);
-                    break;
-                case 'file':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('file', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must be a file upload', $attribute['description'][0]);
-                    break;
-                case 'image':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('image', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must be an image (jpeg, png, bmp, gif, or svg)', $attribute['description'][0]);
-                    break;
-                case 'in':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('`jpeg`, `png`, `bmp`, `gif` or `svg`', $attribute['description'][0]);
-                    break;
-                case 'integer':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('integer', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'ip':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('ip', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'json':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must be a valid JSON string.', $attribute['description'][0]);
-                    break;
-                case 'max':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Maximum: `10`', $attribute['description'][0]);
-                    break;
-                case 'min':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Minimum: `20`', $attribute['description'][0]);
-                    break;
-                case 'mimes':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Allowed mime types: `jpeg`, `bmp` or `png`', $attribute['description'][0]);
-                    break;
-                case 'not_in':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Not in: `foo` or `bar`', $attribute['description'][0]);
-                    break;
-                case 'numeric':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('numeric', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-                case 'regex':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must match this regular expression: `(.*)`', $attribute['description'][0]);
-                    break;
-                case 'multiple_required_if':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required if `foo` is `bar` or `baz` is `qux`', $attribute['description'][0]);
-                    break;
-                case 'required_if':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required if `foo` is `bar`', $attribute['description'][0]);
-                    break;
-                case 'required_unless':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required unless `foo` is `bar`', $attribute['description'][0]);
-                    break;
-                case 'required_with':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required if the parameters `foo`, `bar` or `baz` are present.', $attribute['description'][0]);
-                    break;
-                case 'required_with_all':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required if the parameters `foo`, `bar` and `baz` are present.', $attribute['description'][0]);
-                    break;
-                case 'required_without':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required if the parameters `foo`, `bar` or `baz` are not present.', $attribute['description'][0]);
-                    break;
-                case 'required_without_all':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Required if the parameters `foo`, `bar` and `baz` are not present.', $attribute['description'][0]);
-                    break;
-                case 'same':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must be the same as `foo`', $attribute['description'][0]);
-                    break;
-                case 'size':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must have the size of `51`', $attribute['description'][0]);
-                    break;
-                case 'timezone':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('string', $attribute['type']);
-                    $this->assertCount(1, $attribute['description']);
-                    $this->assertSame('Must be a valid timezone identifier', $attribute['description'][0]);
-                    break;
-                case 'url':
-                    $this->assertFalse($attribute['required']);
-                    $this->assertSame('url', $attribute['type']);
-                    $this->assertCount(0, $attribute['description']);
-                    break;
-
-            }
-        }
-    }
-}
diff --git a/tests/Fixtures/CustomValidatorRequest.php b/tests/Fixtures/CustomValidatorRequest.php
deleted file mode 100644
index 9ce53682..00000000
--- a/tests/Fixtures/CustomValidatorRequest.php
+++ /dev/null
@@ -1,30 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Tests\Fixtures;
-
-use Illuminate\Foundation\Http\FormRequest;
-
-class CustomValidatorRequest extends FormRequest
-{
-    /**
-     * Validate the input.
-     *
-     * @param \Illuminate\Validation\Factory $factory
-     *
-     * @return \Illuminate\Validation\Validator
-     */
-    public function validator($factory)
-    {
-        return $factory->make(
-            $this->validationData(), $this->container->call([$this, 'foo']),
-            $this->messages(), $this->attributes()
-        );
-    }
-
-    public function foo()
-    {
-        return [
-            'required' => 'required',
-        ];
-    }
-}
diff --git a/tests/Fixtures/DependencyInjection.php b/tests/Fixtures/DependencyInjection.php
deleted file mode 100644
index 96ee56c0..00000000
--- a/tests/Fixtures/DependencyInjection.php
+++ /dev/null
@@ -1,18 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Tests\Fixtures;
-
-use Illuminate\Contracts\Filesystem\Filesystem;
-
-class DependencyInjection
-{
-    /**
-     * @var
-     */
-    private $filesystem;
-
-    public function __construct(Filesystem $filesystem)
-    {
-        $this->filesystem = $filesystem;
-    }
-}
diff --git a/tests/Fixtures/DingoTestController.php b/tests/Fixtures/DingoTestController.php
deleted file mode 100644
index 63099d28..00000000
--- a/tests/Fixtures/DingoTestController.php
+++ /dev/null
@@ -1,28 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Tests\Fixtures;
-
-use Illuminate\Routing\Controller;
-
-class DingoTestController extends Controller
-{
-    public function dummy()
-    {
-        return '';
-    }
-
-    /**
-     * Example title.
-     * This will be the long description.
-     * It can also be multiple lines long.
-     */
-    public function parseMethodDescription()
-    {
-        return '';
-    }
-
-    public function parseFormRequestRules(DingoTestRequest $request)
-    {
-        return '';
-    }
-}
diff --git a/tests/Fixtures/DingoTestRequest.php b/tests/Fixtures/DingoTestRequest.php
deleted file mode 100644
index a929b6c5..00000000
--- a/tests/Fixtures/DingoTestRequest.php
+++ /dev/null
@@ -1,56 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Tests\Fixtures;
-
-use Dingo\Api\Http\FormRequest;
-
-class DingoTestRequest extends FormRequest
-{
-    public function rules()
-    {
-        return [
-            'required' => 'required',
-            'accepted' => 'accepted',
-            'after' => 'after:2016-04-23 14:31:00',
-            'active_url' => 'active_url',
-            'alpha' => 'alpha',
-            'alpha_dash' => 'alpha_dash',
-            'alpha_num' => 'alpha_num',
-            'array' => 'array',
-            'before' => 'before:2016-04-23 14:31:00',
-            'between' => 'between:5,200',
-            'string_between' => 'string|between:5,200',
-            'boolean' => 'boolean',
-            'date' => 'date',
-            'date_format' => 'date_format:j.n.Y H:iP',
-            'different' => 'different:alpha_num',
-            'digits' => 'digits:2',
-            'digits_between' => 'digits_between:2,10',
-            'exists' => 'exists:users,firstname',
-            'single_exists' => 'exists:users',
-            'file' => 'file',
-            'in' => 'in:jpeg,png,bmp,gif,svg',
-            'integer' => 'integer',
-            'image' => 'image',
-            'ip' => 'ip',
-            'json' => 'json',
-            'min' => 'min:20',
-            'max' => 'max:10',
-            'mimes' => 'mimes:jpeg,bmp,png',
-            'not_in' => 'not_in:foo,bar',
-            'numeric' => 'numeric',
-            'regex' => 'regex:(.*)',
-            'required_if' => 'required_if:foo,bar',
-            'multiple_required_if' => 'required_if:foo,bar,baz,qux',
-            'required_unless' => 'required_unless:foo,bar',
-            'required_with' => 'required_with:foo,bar,baz',
-            'required_with_all' => 'required_with_all:foo,bar,baz',
-            'required_without' => 'required_without:foo,bar,baz',
-            'required_without_all' => 'required_without_all:foo,bar,baz',
-            'same' => 'same:foo',
-            'size' => 'size:51',
-            'timezone' => 'timezone',
-            'url' => 'url',
-        ];
-    }
-}
diff --git a/tests/Fixtures/DynamicRequest.php b/tests/Fixtures/DynamicRequest.php
deleted file mode 100644
index d370d231..00000000
--- a/tests/Fixtures/DynamicRequest.php
+++ /dev/null
@@ -1,15 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Tests\Fixtures;
-
-use Illuminate\Foundation\Http\FormRequest;
-
-class DynamicRequest extends FormRequest
-{
-    public function rules()
-    {
-        return [
-            'not_in' => 'not_in:'.$this->foo,
-        ];
-    }
-}
diff --git a/tests/Fixtures/TestController.php b/tests/Fixtures/TestController.php
index ddae227c..21a28e24 100644
--- a/tests/Fixtures/TestController.php
+++ b/tests/Fixtures/TestController.php
@@ -4,7 +4,11 @@
 
 use Illuminate\Http\Request;
 use Illuminate\Routing\Controller;
+use Mpociot\ApiDoc\Tests\Unit\GeneratorTestCase;
 
+/**
+ * @group Group A
+ */
 class TestController extends Controller
 {
     public function dummy()
@@ -17,55 +21,235 @@ public function dummy()
      * This will be the long description.
      * It can also be multiple lines long.
      */
-    public function parseMethodDescription()
+    public function withEndpointDescription()
     {
         return '';
     }
 
-    public function parseFormRequestRules(TestRequest $request)
+    /**
+     * @group Group B
+     */
+    public function withGroupOverride()
+    {
+        return 'Group B, baby!';
+    }
+
+    /**
+     * This is also in Group B. No route description. Route title before gropp.
+     *
+     * @group Group B
+     */
+    public function withGroupOverride2()
+    {
+        return '';
+    }
+
+    /**
+     * @group Group B
+     *
+     * This is also in Group B. Route title after group.
+     */
+    public function withGroupOverride3()
+    {
+        return '';
+    }
+
+    /**
+     * This is in Group C. Route title before group.
+     *
+     * @group Group C
+     *
+     * Group description after group.
+     */
+    public function withGroupOverride4()
+    {
+        return '';
+    }
+
+    /**
+     * Endpoint with body parameters.
+     *
+     * @bodyParam user_id int required The id of the user. Example: 9
+     * @bodyParam room_id string The id of the room.
+     * @bodyParam forever boolean Whether to ban the user forever. Example: false
+     * @bodyParam another_one number Just need something here.
+     * @bodyParam yet_another_param object required Some object params.
+     * @bodyParam yet_another_param.name string required Subkey in the object param.
+     * @bodyParam even_more_param array Some array params.
+     * @bodyParam even_more_param.* float Subkey in the array param.
+     * @bodyParam book.name string
+     * @bodyParam book.author_id integer
+     * @bodyParam book[pages_count] integer
+     * @bodyParam ids.* integer
+     * @bodyParam users.*.first_name string The first name of the user. Example: John
+     * @bodyParam users.*.last_name string The last name of the user. Example: Doe
+     */
+    public function withBodyParameters()
+    {
+        return '';
+    }
+
+    /**
+     * Endpoint with body parameters as array.
+     *
+     * @bodyParam *.first_name string The first name of the user. Example: John
+     * @bodyParam *.last_name string The last name of the user. Example: Doe
+     * @bodyParam *.contacts.*.first_name string The first name of the contact. Example: John
+     * @bodyParam *.contacts.*.last_name string The last name of the contact. Example: Doe
+     * @bodyParam *.roles.* string The name of the role. Example: Admin
+     */
+    public function withBodyParametersAsArray()
+    {
+        return '';
+    }
+
+    public function withFormRequestParameter(TestRequest $request)
     {
         return '';
     }
 
-    public function customFormRequestValidator(CustomValidatorRequest $request)
+    public function withMultipleFormRequestParameters(string $test, TestRequest $request)
     {
         return '';
     }
 
-    public function addRouteBindingsToRequestClass(DynamicRequest $request)
+    /**
+     * @bodyParam direct_one string Is found directly on the method.
+     */
+    public function withNonCommentedFormRequestParameter(TestNonCommentedRequest $request)
     {
         return '';
     }
 
+    /**
+     * @queryParam location_id required The id of the location.
+     * @queryParam user_id required The id of the user. Example: me
+     * @queryParam page required The page number. Example: 4
+     * @queryParam filters  The filters.
+     * @queryParam url_encoded  Used for testing that URL parameters will be URL-encoded where needed. Example: + []&=
+     */
+    public function withQueryParameters()
+    {
+        return '';
+    }
+
+    /**
+     * @bodyParam included string required Exists in examples. Example: 'Here'
+     * @bodyParam  excluded_body_param int Does not exist in examples. No-example
+     * @queryParam excluded_query_param Does not exist in examples. No-example
+     */
+    public function withExcludedExamples()
+    {
+        return '';
+    }
+
+    /**
+     * @authenticated
+     */
+    public function withAuthenticatedTag()
+    {
+        return '';
+    }
+
+    /**
+     * @apiResource \Mpociot\ApiDoc\Tests\Fixtures\TestUserApiResource
+     * @apiResourceModel \Mpociot\ApiDoc\Tests\Fixtures\TestUser
+     */
+    public function withEloquentApiResource()
+    {
+        return new TestUserApiResource(factory(TestUser::class)->make(['id' => 0]));
+    }
+
+    /**
+     * @group Other😎
+     *
+     * @apiResourceCollection Mpociot\ApiDoc\Tests\Fixtures\TestUserApiResource
+     * @apiResourceModel Mpociot\ApiDoc\Tests\Fixtures\TestUser
+     */
+    public function withEloquentApiResourceCollection()
+    {
+        return TestUserApiResource::collection(
+            collect([factory(TestUser::class)->make(['id' => 0])])
+        );
+    }
+
+    /**
+     * @group Other😎
+     *
+     * @apiResourceCollection Mpociot\ApiDoc\Tests\Fixtures\TestUserApiResourceCollection
+     * @apiResourceModel Mpociot\ApiDoc\Tests\Fixtures\TestUser
+     */
+    public function withEloquentApiResourceCollectionClass()
+    {
+        return new TestUserApiResourceCollection(
+            collect([factory(TestUser::class)->make(['id' => 0])])
+        );
+    }
+
     public function checkCustomHeaders(Request $request)
     {
         return $request->headers->all();
     }
 
-    public function fetchRouteResponse()
+    public function shouldFetchRouteResponse()
     {
-        $fixture = new \stdClass();
-        $fixture->id = 1;
-        $fixture->name = 'banana';
-        $fixture->color = 'red';
-        $fixture->weight = 300;
-        $fixture->delicious = 1;
+        $fruit = new \stdClass();
+        $fruit->id = 4;
+        $fruit->name = ' banana  ';
+        $fruit->color = 'RED';
+        $fruit->weight = 1;
+        $fruit->delicious = true;
 
         return [
-            'id' => (int) $fixture->id,
-            'name' => ucfirst($fixture->name),
-            'color' => ucfirst($fixture->color),
-            'weight' => $fixture->weight.' grams',
-            'delicious' => (bool) $fixture->delicious,
+            'id' => (int) $fruit->id,
+            'name' => trim($fruit->name),
+            'color' => strtolower($fruit->color),
+            'weight' => $fruit->weight . ' kg',
+            'delicious' => $fruit->delicious,
+            'responseCall' => true,
         ];
     }
 
-    public function dependencyInjection(DependencyInjection $dependency, TestRequest $request)
+    public function echoesConfig()
     {
-        return '';
+        return [
+            'app.env' => config('app.env'),
+        ];
     }
 
-    public function utf8()
+    /**
+     * @group Other😎
+     *
+     * @urlParam param required Example: 4
+     * @urlParam param2
+     * @urlParam param4 No-example.
+     *
+     * @queryParam something
+     */
+    public function echoesUrlParameters($param, $param2, $param3 = null, $param4 = null)
+    {
+        return compact('param', 'param2', 'param3', 'param4');
+    }
+
+    /**
+     * @urlparam $id Example: 3
+     */
+    public function shouldFetchRouteResponseWithEchoedSettings($id)
+    {
+        return [
+            '{id}' => $id,
+            'header' => request()->header('header'),
+            'queryParam' => request()->query('queryParam'),
+            'bodyParam' => request()->get('bodyParam'),
+        ];
+    }
+
+    /**
+     * @response {
+     *   "result": "Лорем ипсум долор сит амет"
+     * }
+     */
+    public function withUtf8ResponseTag()
     {
         return ['result' => 'Лорем ипсум долор сит амет'];
     }
@@ -79,10 +263,45 @@ public function skip()
 
     /**
      * @response {
-     *  "data": []
-     *}
+     *   "id": 4,
+     *   "name": "banana",
+     *   "color": "red",
+     *   "weight": "1 kg",
+     *   "delicious": true,
+     *   "responseTag": true
+     * }
+     */
+    public function withResponseTag()
+    {
+        GeneratorTestCase::$globalValue = rand();
+
+        return '';
+    }
+
+    /**
+     * @response 422 {
+     *   "message": "Validation error"
+     * }
+     */
+    public function withResponseTagAndStatusCode()
+    {
+        return '';
+    }
+
+    /**
+     * @response {
+     *   "id": 4,
+     *   "name": "banana",
+     *   "color": "red",
+     *   "weight": "1 kg",
+     *   "delicious": true,
+     *   "multipleResponseTagsAndStatusCodes": true
+     * }
+     * @response 401 {
+     *   "message": "Unauthorized"
+     * }
      */
-    public function responseTag()
+    public function withMultipleResponseTagsAndStatusCode()
     {
         return '';
     }
@@ -95,6 +314,14 @@ public function transformerTag()
         return '';
     }
 
+    /**
+     * @transformer 201 \Mpociot\ApiDoc\Tests\Fixtures\TestTransformer
+     */
+    public function transformerTagWithStatusCode()
+    {
+        return '';
+    }
+
     /**
      * @transformer \Mpociot\ApiDoc\Tests\Fixtures\TestTransformer
      * @transformermodel \Mpociot\ApiDoc\Tests\Fixtures\TestModel
@@ -120,4 +347,37 @@ public function transformerCollectionTagWithModel()
     {
         return '';
     }
+
+    /**
+     * @responseFile response_test.json
+     */
+    public function responseFileTag()
+    {
+        return '';
+    }
+
+    /**
+     * @responseFile response_test.json
+     * @responseFile 401 response_error_test.json
+     */
+    public function withResponseFileTagAndStatusCode()
+    {
+        return '';
+    }
+
+    /**
+     * @responseFile response_test.json {"message" : "Serendipity"}
+     */
+    public function responseFileTagAndCustomJson()
+    {
+        return '';
+    }
+
+    /**
+     * @responseFile i-do-not-exist.json
+     */
+    public function withNonExistentResponseFile()
+    {
+        return '';
+    }
 }
diff --git a/tests/Fixtures/TestGroupController.php b/tests/Fixtures/TestGroupController.php
new file mode 100644
index 00000000..0bce4cd6
--- /dev/null
+++ b/tests/Fixtures/TestGroupController.php
@@ -0,0 +1,43 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests\Fixtures;
+
+/**
+ * @group 1. Group 1
+ *
+ * Group 1 APIs
+ */
+class TestGroupController
+{
+    /**
+     * Some endpoint.
+     *
+     * By default, this is in Group 1.
+     */
+    public function action1()
+    {
+    }
+
+    /**
+     * Another endpoint.
+     *
+     * Here we specify a group. This is also in Group 1.
+     *
+     * @group 1. Group 1
+     */
+    public function action1b()
+    {
+    }
+
+    /**
+     * @group 2. Group 2
+     */
+    public function action2()
+    {
+    }
+
+    /** @group 10. Group 10 */
+    public function action10()
+    {
+    }
+}
diff --git a/tests/Fixtures/TestNonCommentedRequest.php b/tests/Fixtures/TestNonCommentedRequest.php
new file mode 100644
index 00000000..18ada51a
--- /dev/null
+++ b/tests/Fixtures/TestNonCommentedRequest.php
@@ -0,0 +1,9 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests\Fixtures;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class TestNonCommentedRequest extends FormRequest
+{
+}
diff --git a/tests/Fixtures/TestPartialResourceController.php b/tests/Fixtures/TestPartialResourceController.php
new file mode 100644
index 00000000..1c188ba5
--- /dev/null
+++ b/tests/Fixtures/TestPartialResourceController.php
@@ -0,0 +1,20 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests\Fixtures;
+
+class TestPartialResourceController
+{
+    /**
+     * @group Group A
+     */
+    public function index()
+    {
+    }
+
+    /**
+     * @group Group B
+     */
+    public function update()
+    {
+    }
+}
diff --git a/tests/Fixtures/TestRequest.php b/tests/Fixtures/TestRequest.php
index 5268030c..4847e420 100644
--- a/tests/Fixtures/TestRequest.php
+++ b/tests/Fixtures/TestRequest.php
@@ -4,53 +4,20 @@
 
 use Illuminate\Foundation\Http\FormRequest;
 
+/**
+ * @bodyParam user_id int required The id of the user. Example: 9
+ * @bodyParam room_id string The id of the room.
+ * @bodyParam forever boolean Whether to ban the user forever. Example: false
+ * @bodyParam another_one number Just need something here.
+ * @bodyParam yet_another_param object required
+ * @bodyParam even_more_param array
+ * @bodyParam book.name string
+ * @bodyParam book.author_id integer
+ * @bodyParam book[pages_count] integer
+ * @bodyParam ids.* integer
+ * @bodyParam users.*.first_name string The first name of the user. Example: John
+ * @bodyParam users.*.last_name string The last name of the user. Example: Doe
+ */
 class TestRequest extends FormRequest
 {
-    public function rules()
-    {
-        return [
-            'required' => 'required',
-            'accepted' => 'accepted',
-            'after' => 'after:2016-04-23 14:31:00',
-            'active_url' => 'active_url',
-            'alpha' => 'alpha',
-            'alpha_dash' => 'alpha_dash',
-            'alpha_num' => 'alpha_num',
-            'array' => 'array',
-            'before' => 'before:2016-04-23 14:31:00',
-            'between' => 'between:5,200',
-            'string_between' => 'string|between:5,200',
-            'boolean' => 'boolean',
-            'date' => 'date',
-            'date_format' => 'date_format:j.n.Y H:iP',
-            'different' => 'different:alpha_num',
-            'digits' => 'digits:2',
-            'digits_between' => 'digits_between:2,10',
-            'exists' => 'exists:users,firstname',
-            'file' => 'file',
-            'single_exists' => 'exists:users',
-            'in' => 'in:jpeg,png,bmp,gif,svg',
-            'image' => 'image',
-            'integer' => 'integer',
-            'ip' => 'ip',
-            'json' => 'json',
-            'min' => 'min:20',
-            'max' => 'max:10',
-            'mimes' => 'mimes:jpeg,bmp,png',
-            'not_in' => 'not_in:foo,bar',
-            'numeric' => 'numeric',
-            'regex' => 'regex:(.*)',
-            'required_if' => 'required_if:foo,bar',
-            'multiple_required_if' => 'required_if:foo,bar,baz,qux',
-            'required_unless' => 'required_unless:foo,bar',
-            'required_with' => 'required_with:foo,bar,baz',
-            'required_with_all' => 'required_with_all:foo,bar,baz',
-            'required_without' => 'required_without:foo,bar,baz',
-            'required_without_all' => 'required_without_all:foo,bar,baz',
-            'same' => 'same:foo',
-            'size' => 'size:51',
-            'timezone' => 'timezone',
-            'url' => 'url',
-        ];
-    }
 }
diff --git a/tests/Fixtures/TestResourceController.php b/tests/Fixtures/TestResourceController.php
index aae43b86..3c5a7caf 100644
--- a/tests/Fixtures/TestResourceController.php
+++ b/tests/Fixtures/TestResourceController.php
@@ -10,6 +10,10 @@ class TestResourceController extends Controller
     /**
      * Display a listing of the resource.
      *
+     * @response {
+     *   "index_resource": true
+     * }
+     *
      * @return \Illuminate\Http\Response
      */
     public function index()
@@ -22,6 +26,10 @@ public function index()
     /**
      * Show the form for creating a new resource.
      *
+     * @response {
+     *   "create_resource": true
+     * }
+     *
      * @return \Illuminate\Http\Response
      */
     public function create()
@@ -40,14 +48,15 @@ public function create()
      */
     public function store(Request $request)
     {
-        return [
-            'store_resource' => true,
-        ];
     }
 
     /**
      * Display the specified resource.
      *
+     * @response {
+     *   "show_resource": true
+     * }
+     *
      * @param  int  $id
      *
      * @return \Illuminate\Http\Response
@@ -55,13 +64,17 @@ public function store(Request $request)
     public function show($id)
     {
         return [
-            'show_resource' => $id,
+            'show_resource' => true,
         ];
     }
 
     /**
      * Show the form for editing the specified resource.
      *
+     * @response {
+     *   "edit_resource": true
+     * }
+     *
      * @param  int  $id
      *
      * @return \Illuminate\Http\Response
@@ -69,7 +82,7 @@ public function show($id)
     public function edit($id)
     {
         return [
-            'edit_resource' => $id,
+            'edit_resource' => true,
         ];
     }
 
@@ -83,9 +96,6 @@ public function edit($id)
      */
     public function update(Request $request, $id)
     {
-        return [
-            'update_resource' => $id,
-        ];
     }
 
     /**
@@ -97,8 +107,5 @@ public function update(Request $request, $id)
      */
     public function destroy($id)
     {
-        return [
-            'destroy_resource' => $id,
-        ];
     }
 }
diff --git a/tests/Fixtures/TestUser.php b/tests/Fixtures/TestUser.php
new file mode 100644
index 00000000..a24188e0
--- /dev/null
+++ b/tests/Fixtures/TestUser.php
@@ -0,0 +1,9 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests\Fixtures;
+
+use Illuminate\Database\Eloquent\Model;
+
+class TestUser extends Model
+{
+}
diff --git a/tests/Fixtures/TestUserApiResource.php b/tests/Fixtures/TestUserApiResource.php
new file mode 100644
index 00000000..4e529853
--- /dev/null
+++ b/tests/Fixtures/TestUserApiResource.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests\Fixtures;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class TestUserApiResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     *
+     * @return array
+     */
+    public function toArray($request)
+    {
+        return [
+            'id' => $this->id,
+            'name' => $this->first_name . ' ' . $this->last_name,
+            'email' => $this->email,
+        ];
+    }
+}
diff --git a/tests/Fixtures/TestUserApiResourceCollection.php b/tests/Fixtures/TestUserApiResourceCollection.php
new file mode 100644
index 00000000..1922659a
--- /dev/null
+++ b/tests/Fixtures/TestUserApiResourceCollection.php
@@ -0,0 +1,25 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests\Fixtures;
+
+use Illuminate\Http\Resources\Json\ResourceCollection;
+
+class TestUserApiResourceCollection extends ResourceCollection
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     *
+     * @return array
+     */
+    public function toArray($request)
+    {
+        return [
+            'data' => $this->collection,
+            'links' => [
+                'self' => 'link-value',
+            ],
+        ];
+    }
+}
diff --git a/tests/Fixtures/collection.json b/tests/Fixtures/collection.json
index 5dfe5567..60cc4d27 100644
--- a/tests/Fixtures/collection.json
+++ b/tests/Fixtures/collection.json
@@ -1 +1,399 @@
-{"variables":[],"info":{"name":"","_postman_id":"","description":"","schema":"https:\/\/schema.getpostman.com\/json\/collection\/v2.0.0\/collection.json"},"item":[{"name":"general","description":"","item":[{"name":"Example title.","request":{"url":"http:\/\/localhost\/api\/test","method":"GET","body":{"mode":"formdata","formdata":[]},"description":"This will be the long description.\nIt can also be multiple lines long.","response":[]}},{"name":"http:\/\/localhost\/api\/fetch","request":{"url":"http:\/\/localhost\/api\/fetch","method":"POST","body":{"mode":"formdata","formdata":[]},"description":"","response":[]}}]}]}
\ No newline at end of file
+{
+    "variables": [],
+    "info": {
+        "name": "Laravel API",
+        "_postman_id": "",
+        "description": "",
+        "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.0.0\/collection.json"
+    },
+    "item": [
+        {
+            "name": "Group A",
+            "description": "",
+            "item": [
+                {
+                    "name": "Example title.",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "localhost",
+                            "path": "api\/withDescription",
+                            "query": []
+                        },
+                        "method": "GET",
+                        "header": [
+                            {
+                                "key": "Authorization",
+                                "value": "customAuthToken"
+                            },
+                            {
+                                "key": "Custom-Header",
+                                "value": "NotSoCustom"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "This will be the long description.\nIt can also be multiple lines long.",
+                        "response": []
+                    }
+                },
+                {
+                    "name": "api\/withResponseTag",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "localhost",
+                            "path": "api\/withResponseTag",
+                            "query": []
+                        },
+                        "method": "GET",
+                        "header": [
+                            {
+                                "key": "Authorization",
+                                "value": "customAuthToken"
+                            },
+                            {
+                                "key": "Custom-Header",
+                                "value": "NotSoCustom"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                },
+                {
+                    "name": "Endpoint with body parameters.",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "localhost",
+                            "path": "api\/withBodyParameters",
+                            "query": []
+                        },
+                        "method": "POST",
+                        "header": [
+                            {
+                                "key": "Authorization",
+                                "value": "customAuthToken"
+                            },
+                            {
+                                "key": "Custom-Header",
+                                "value": "NotSoCustom"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "{\n    \"user_id\": 9,\n    \"room_id\": \"consequatur\",\n    \"forever\": false,\n    \"another_one\": 11613.31890586,\n    \"yet_another_param\": {\n        \"name\": \"consequatur\"\n    },\n    \"even_more_param\": [\n        11613.31890586\n    ],\n    \"book\": {\n        \"name\": \"consequatur\",\n        \"author_id\": 17,\n        \"pages_count\": 17\n    },\n    \"ids\": [\n        17\n    ],\n    \"users\": [\n        {\n            \"first_name\": \"John\",\n            \"last_name\": \"Doe\"\n        }\n    ]\n}"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                },
+                {
+                    "name": "api\/withQueryParameters",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "localhost",
+                            "path": "api\/withQueryParameters",
+                            "query": [
+                                {
+                                    "key": "location_id",
+                                    "value": "consequatur",
+                                    "description": "The id of the location.",
+                                    "disabled": false
+                                },
+                                {
+                                    "key": "user_id",
+                                    "value": "me",
+                                    "description": "The id of the user.",
+                                    "disabled": false
+                                },
+                                {
+                                    "key": "page",
+                                    "value": "4",
+                                    "description": "The page number.",
+                                    "disabled": false
+                                },
+                                {
+                                    "key": "filters",
+                                    "value": "consequatur",
+                                    "description": "The filters.",
+                                    "disabled": false
+                                },
+                                {
+                                    "key": "url_encoded",
+                                    "value": "%2B+%5B%5D%26%3D",
+                                    "description": "Used for testing that URL parameters will be URL-encoded where needed.",
+                                    "disabled": false
+                                }
+                            ]
+                        },
+                        "method": "GET",
+                        "header": [
+                            {
+                                "key": "Authorization",
+                                "value": "customAuthToken"
+                            },
+                            {
+                                "key": "Custom-Header",
+                                "value": "NotSoCustom"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                },
+                {
+                    "name": "api\/withAuthTag",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "localhost",
+                            "path": "api\/withAuthTag",
+                            "query": []
+                        },
+                        "method": "GET",
+                        "header": [
+                            {
+                                "key": "Authorization",
+                                "value": "customAuthToken"
+                            },
+                            {
+                                "key": "Custom-Header",
+                                "value": "NotSoCustom"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                },
+                {
+                    "name": "api\/withEloquentApiResource",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "localhost",
+                            "path": "api\/withEloquentApiResource",
+                            "query": []
+                        },
+                        "method": "GET",
+                        "header": [
+                            {
+                                "key": "Authorization",
+                                "value": "customAuthToken"
+                            },
+                            {
+                                "key": "Custom-Header",
+                                "value": "NotSoCustom"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                },
+                {
+                    "name": "api\/withMultipleResponseTagsAndStatusCode",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "localhost",
+                            "path": "api\/withMultipleResponseTagsAndStatusCode",
+                            "query": []
+                        },
+                        "method": "POST",
+                        "header": [
+                            {
+                                "key": "Authorization",
+                                "value": "customAuthToken"
+                            },
+                            {
+                                "key": "Custom-Header",
+                                "value": "NotSoCustom"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                }
+            ]
+        },
+        {
+            "name": "Other\ud83d\ude0e",
+            "description": "",
+            "item": [
+                {
+                    "name": "api\/withEloquentApiResourceCollectionClass",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "localhost",
+                            "path": "api\/withEloquentApiResourceCollectionClass",
+                            "query": []
+                        },
+                        "method": "GET",
+                        "header": [
+                            {
+                                "key": "Authorization",
+                                "value": "customAuthToken"
+                            },
+                            {
+                                "key": "Custom-Header",
+                                "value": "NotSoCustom"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                },
+                {
+                    "name": "api\/echoesUrlParameters\/{param}-{param2}\/{param3?}",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "localhost",
+                            "path": "api\/echoesUrlParameters\/{param}-{param2}\/:param3",
+                            "query": [
+                                {
+                                    "key": "something",
+                                    "value": "consequatur",
+                                    "description": "",
+                                    "disabled": false
+                                }
+                            ],
+                            "variable": [
+                                {
+                                    "id": "param",
+                                    "key": "param",
+                                    "value": "4",
+                                    "description": ""
+                                },
+                                {
+                                    "id": "param2",
+                                    "key": "param2",
+                                    "value": "consequatur",
+                                    "description": ""
+                                }
+                            ]
+                        },
+                        "method": "GET",
+                        "header": [
+                            {
+                                "key": "Authorization",
+                                "value": "customAuthToken"
+                            },
+                            {
+                                "key": "Custom-Header",
+                                "value": "NotSoCustom"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                }
+            ]
+        }
+    ]
+}
diff --git a/tests/Fixtures/collection_custom_url.json b/tests/Fixtures/collection_custom_url.json
new file mode 100644
index 00000000..2938a4bf
--- /dev/null
+++ b/tests/Fixtures/collection_custom_url.json
@@ -0,0 +1,73 @@
+{
+    "variables": [],
+    "info": {
+        "name": "Laravel API",
+        "_postman_id": "",
+        "description": "",
+        "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.0.0\/collection.json"
+    },
+    "item": [
+        {
+            "name": "Group A",
+            "description": "",
+            "item": [
+                {
+                    "name": "Example title.",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "yourapp.app",
+                            "path": "api/test",
+                            "query": []
+                        },
+                        "method": "GET",
+                        "header": [
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "This will be the long description.\nIt can also be multiple lines long.",
+                        "response": []
+                    }
+                },
+                {
+                    "name": "api\/responseTag",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "yourapp.app",
+                            "path": "api/responseTag",
+                            "query": []
+                        },
+                        "method": "POST",
+                        "header": [
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                }
+            ]
+        }
+    ]
+}
diff --git a/tests/Fixtures/collection_with_body_parameters.json b/tests/Fixtures/collection_with_body_parameters.json
new file mode 100644
index 00000000..35ad5a18
--- /dev/null
+++ b/tests/Fixtures/collection_with_body_parameters.json
@@ -0,0 +1,45 @@
+{
+    "variables": [],
+    "info": {
+        "name": "Laravel API",
+        "_postman_id": "",
+        "description": "",
+        "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.0.0\/collection.json"
+    },
+    "item": [
+        {
+            "name": "Group A",
+            "description": "",
+            "item": [
+                {
+                    "name": "Endpoint with body parameters.",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "localhost",
+                            "path": "api\/withBodyParameters",
+                            "query": []
+                        },
+                        "method": "GET",
+                        "header": [
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "{\n    \"user_id\": 9,\n    \"room_id\": \"consequatur\",\n    \"forever\": false,\n    \"another_one\": 11613.31890586,\n    \"yet_another_param\": {\n        \"name\": \"consequatur\"\n    },\n    \"even_more_param\": [\n        11613.31890586\n    ],\n    \"book\": {\n        \"name\": \"consequatur\",\n        \"author_id\": 17,\n        \"pages_count\": 17\n    },\n    \"ids\": [\n        17\n    ],\n    \"users\": [\n        {\n            \"first_name\": \"John\",\n            \"last_name\": \"Doe\"\n        }\n    ]\n}"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                }
+            ]
+        }
+    ]
+}
diff --git a/tests/Fixtures/collection_with_custom_headers.json b/tests/Fixtures/collection_with_custom_headers.json
new file mode 100644
index 00000000..ac79279b
--- /dev/null
+++ b/tests/Fixtures/collection_with_custom_headers.json
@@ -0,0 +1,49 @@
+{
+    "variables": [],
+    "info": {
+        "name": "Laravel API",
+        "_postman_id": "",
+        "description": "",
+        "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.0.0\/collection.json"
+    },
+    "item": [
+        {
+            "name": "Group A",
+            "description": "",
+            "item": [
+                {
+                    "name": "api\/headers",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "localhost",
+                            "path": "api/headers",
+                            "query": []
+                        },
+                        "method": "GET",
+                        "header": [
+                            {
+                                "key": "Authorization",
+                                "value": "customAuthToken"
+                            },
+                            {
+                                "key": "Custom-Header",
+                                "value": "NotSoCustom"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                }
+            ]
+        }
+    ]
+}
diff --git a/tests/Fixtures/collection_with_query_parameters.json b/tests/Fixtures/collection_with_query_parameters.json
new file mode 100644
index 00000000..a04043e6
--- /dev/null
+++ b/tests/Fixtures/collection_with_query_parameters.json
@@ -0,0 +1,76 @@
+{
+    "variables": [],
+    "info": {
+        "name": "Laravel API",
+        "_postman_id": "",
+        "description": "",
+        "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.0.0\/collection.json"
+    },
+    "item": [
+        {
+            "name": "Group A",
+            "description": "",
+            "item": [
+                {
+                    "name": "api\/withQueryParameters",
+                    "request": {
+                        "url": {
+                            "protocol": "http",
+                            "host": "localhost",
+                            "path": "api\/withQueryParameters",
+                            "query": [
+                                {
+                                    "key": "location_id",
+                                    "value": "consequatur",
+                                    "description": "The id of the location.",
+                                    "disabled": false
+                                },
+                                {
+                                    "key": "user_id",
+                                    "value": "me",
+                                    "description": "The id of the user.",
+                                    "disabled": false
+                                },
+                                {
+                                    "key": "page",
+                                    "value": "4",
+                                    "description": "The page number.",
+                                    "disabled": false
+                                },
+                                {
+                                    "key": "filters",
+                                    "value": "consequatur",
+                                    "description": "The filters.",
+                                    "disabled": false
+                                },
+                                {
+                                    "key": "url_encoded",
+                                    "value": "%2B+%5B%5D%26%3D",
+                                    "description": "Used for testing that URL parameters will be URL-encoded where needed.",
+                                    "disabled": false
+                                }
+                            ]
+                        },
+                        "method": "GET",
+                        "header": [
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                }
+            ]
+        }
+    ]
+}
diff --git a/tests/Fixtures/collection_with_secure_url.json b/tests/Fixtures/collection_with_secure_url.json
new file mode 100644
index 00000000..e6918665
--- /dev/null
+++ b/tests/Fixtures/collection_with_secure_url.json
@@ -0,0 +1,73 @@
+{
+    "variables": [],
+    "info": {
+        "name": "Laravel API",
+        "_postman_id": "",
+        "description": "",
+        "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.0.0\/collection.json"
+    },
+    "item": [
+        {
+            "name": "Group A",
+            "description": "",
+            "item": [
+                {
+                    "name": "Example title.",
+                    "request": {
+                        "url": {
+                            "protocol": "https",
+                            "host": "yourapp.app",
+                            "path": "api/test",
+                            "query": []
+                        },
+                        "method": "GET",
+                        "header": [
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "This will be the long description.\nIt can also be multiple lines long.",
+                        "response": []
+                    }
+                },
+                {
+                    "name": "api\/responseTag",
+                    "request": {
+                        "url": {
+                            "protocol": "https",
+                            "host": "yourapp.app",
+                            "path": "api/responseTag",
+                            "query": []
+                        },
+                        "method": "POST",
+                        "header": [
+                            {
+                                "key": "Content-Type",
+                                "value": "application\/json"
+                            },
+                            {
+                                "key": "Accept",
+                                "value": "application\/json"
+                            }
+                        ],
+                        "body": {
+                            "mode": "raw",
+                            "raw": "[]"
+                        },
+                        "description": "",
+                        "response": []
+                    }
+                }
+            ]
+        }
+    ]
+}
diff --git a/tests/Fixtures/index.md b/tests/Fixtures/index.md
index 14b0648e..1c2fe91a 100644
--- a/tests/Fixtures/index.md
+++ b/tests/Fixtures/index.md
@@ -20,8 +20,10 @@ Welcome to the generated API reference.
 
 <!-- END_INFO -->
 
-#general
-<!-- START_0bef4e738c9d6720ad43b062015d1078 -->
+#Group A
+
+
+<!-- START_264ee15c728df32e7ca6eedce5e42dcb -->
 ## Example title.
 
 This will be the long description.
@@ -30,80 +32,530 @@ It can also be multiple lines long.
 > Example request:
 
 ```bash
-curl -X GET -G "http://localhost/api/test" \
+curl -X GET \
+    -G "http://localhost/api/withDescription" \
+    -H "Authorization: customAuthToken" \
+    -H "Custom-Header: NotSoCustom" \
+    -H "Content-Type: application/json" \
+    -H "Accept: application/json"
+```
+
+```javascript
+const url = new URL(
+    "http://localhost/api/withDescription"
+);
+
+let headers = {
+    "Authorization": "customAuthToken",
+    "Custom-Header": "NotSoCustom",
+    "Content-Type": "application/json",
+    "Accept": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
+```
+
+
+
+### HTTP Request
+`GET api/withDescription`
+
+
+<!-- END_264ee15c728df32e7ca6eedce5e42dcb -->
+
+<!-- START_9cedd363be06f5512f9e844b100fcc9d -->
+## api/withResponseTag
+> Example request:
+
+```bash
+curl -X GET \
+    -G "http://localhost/api/withResponseTag" \
+    -H "Authorization: customAuthToken" \
+    -H "Custom-Header: NotSoCustom" \
+    -H "Content-Type: application/json" \
     -H "Accept: application/json"
 ```
 
 ```javascript
-var settings = {
-    "async": true,
-    "crossDomain": true,
-    "url": "http://localhost/api/test",
-    "method": "GET",
-    "headers": {
-        "accept": "application/json"
+const url = new URL(
+    "http://localhost/api/withResponseTag"
+);
+
+let headers = {
+    "Authorization": "customAuthToken",
+    "Custom-Header": "NotSoCustom",
+    "Content-Type": "application/json",
+    "Accept": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
+```
+
+
+> Example response (200):
+
+```json
+{
+    "id": 4,
+    "name": "banana",
+    "color": "red",
+    "weight": "1 kg",
+    "delicious": true,
+    "responseTag": true
+}
+```
+
+### HTTP Request
+`GET api/withResponseTag`
+
+
+<!-- END_9cedd363be06f5512f9e844b100fcc9d -->
+
+<!-- START_a25cb3b490fa579d7d77b386bbb7ec03 -->
+## Endpoint with body parameters.
+
+> Example request:
+
+```bash
+curl -X GET \
+    -G "http://localhost/api/withBodyParameters" \
+    -H "Authorization: customAuthToken" \
+    -H "Custom-Header: NotSoCustom" \
+    -H "Content-Type: application/json" \
+    -H "Accept: application/json" \
+    -d '{"user_id":9,"room_id":"consequatur","forever":false,"another_one":11613.31890586,"yet_another_param":{"name":"consequatur"},"even_more_param":[11613.31890586],"book":{"name":"consequatur","author_id":17,"pages_count":17},"ids":[17],"users":[{"first_name":"John","last_name":"Doe"}]}'
+
+```
+
+```javascript
+const url = new URL(
+    "http://localhost/api/withBodyParameters"
+);
+
+let headers = {
+    "Authorization": "customAuthToken",
+    "Custom-Header": "NotSoCustom",
+    "Content-Type": "application/json",
+    "Accept": "application/json",
+};
+
+let body = {
+    "user_id": 9,
+    "room_id": "consequatur",
+    "forever": false,
+    "another_one": 11613.31890586,
+    "yet_another_param": {
+        "name": "consequatur"
+    },
+    "even_more_param": [
+        11613.31890586
+    ],
+    "book": {
+        "name": "consequatur",
+        "author_id": 17,
+        "pages_count": 17
+    },
+    "ids": [
+        17
+    ],
+    "users": [
+        {
+            "first_name": "John",
+            "last_name": "Doe"
+        }
+    ]
+}
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+    body: body
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
+```
+
+
+
+### HTTP Request
+`GET api/withBodyParameters`
+
+#### Body Parameters
+Parameter | Type | Status | Description
+--------- | ------- | ------- | ------- | -----------
+    `user_id` | integer |  required  | The id of the user.
+        `room_id` | string |  optional  | The id of the room.
+        `forever` | boolean |  optional  | Whether to ban the user forever.
+        `another_one` | number |  optional  | Just need something here.
+        `yet_another_param` | object |  required  | Some object params.
+        `yet_another_param.name` | string |  required  | Subkey in the object param.
+        `even_more_param` | array |  optional  | Some array params.
+        `even_more_param.*` | float |  optional  | Subkey in the array param.
+        `book.name` | string |  optional  | 
+        `book.author_id` | integer |  optional  | 
+        `book[pages_count]` | integer |  optional  | 
+        `ids.*` | integer |  optional  | 
+        `users.*.first_name` | string |  optional  | The first name of the user.
+        `users.*.last_name` | string |  optional  | The last name of the user.
+    
+<!-- END_a25cb3b490fa579d7d77b386bbb7ec03 -->
+
+<!-- START_5c545aa7f913d84b23ac4cfefc1de659 -->
+## api/withQueryParameters
+> Example request:
+
+```bash
+curl -X GET \
+    -G "http://localhost/api/withQueryParameters?location_id=consequatur&user_id=me&page=4&filters=consequatur&url_encoded=%2B+%5B%5D%26%3D" \
+    -H "Authorization: customAuthToken" \
+    -H "Custom-Header: NotSoCustom" \
+    -H "Content-Type: application/json" \
+    -H "Accept: application/json"
+```
+
+```javascript
+const url = new URL(
+    "http://localhost/api/withQueryParameters"
+);
+
+let params = {
+    "location_id": "consequatur",
+    "user_id": "me",
+    "page": "4",
+    "filters": "consequatur",
+    "url_encoded": "+ []&=",
+};
+Object.keys(params)
+    .forEach(key => url.searchParams.append(key, params[key]));
+
+let headers = {
+    "Authorization": "customAuthToken",
+    "Custom-Header": "NotSoCustom",
+    "Content-Type": "application/json",
+    "Accept": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
+```
+
+
+
+### HTTP Request
+`GET api/withQueryParameters`
+
+#### Query Parameters
+
+Parameter | Status | Description
+--------- | ------- | ------- | -----------
+    `location_id` |  required  | The id of the location.
+    `user_id` |  required  | The id of the user.
+    `page` |  required  | The page number.
+    `filters` |  optional  | The filters.
+    `url_encoded` |  optional  | Used for testing that URL parameters will be URL-encoded where needed.
+
+<!-- END_5c545aa7f913d84b23ac4cfefc1de659 -->
+
+<!-- START_5c08cc4d72b6e5830f6814c64086e197 -->
+## api/withAuthTag
+<br><small style="padding: 1px 9px 2px;font-weight: bold;white-space: nowrap;color: #ffffff;-webkit-border-radius: 9px;-moz-border-radius: 9px;border-radius: 9px;background-color: #3a87ad;">Requires authentication</small>
+> Example request:
+
+```bash
+curl -X GET \
+    -G "http://localhost/api/withAuthTag" \
+    -H "Authorization: customAuthToken" \
+    -H "Custom-Header: NotSoCustom" \
+    -H "Content-Type: application/json" \
+    -H "Accept: application/json"
+```
+
+```javascript
+const url = new URL(
+    "http://localhost/api/withAuthTag"
+);
+
+let headers = {
+    "Authorization": "customAuthToken",
+    "Custom-Header": "NotSoCustom",
+    "Content-Type": "application/json",
+    "Accept": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
+```
+
+
+
+### HTTP Request
+`GET api/withAuthTag`
+
+
+<!-- END_5c08cc4d72b6e5830f6814c64086e197 -->
+
+<!-- START_16ec1c69d4877579438d48a8ad8dc778 -->
+## api/withEloquentApiResource
+> Example request:
+
+```bash
+curl -X GET \
+    -G "http://localhost/api/withEloquentApiResource" \
+    -H "Authorization: customAuthToken" \
+    -H "Custom-Header: NotSoCustom" \
+    -H "Content-Type: application/json" \
+    -H "Accept: application/json"
+```
+
+```javascript
+const url = new URL(
+    "http://localhost/api/withEloquentApiResource"
+);
+
+let headers = {
+    "Authorization": "customAuthToken",
+    "Custom-Header": "NotSoCustom",
+    "Content-Type": "application/json",
+    "Accept": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
+```
+
+
+> Example response (200):
+
+```json
+{
+    "data": {
+        "id": 4,
+        "name": "Tested Again",
+        "email": "a@b.com"
     }
 }
+```
+
+### HTTP Request
+`GET api/withEloquentApiResource`
+
+
+<!-- END_16ec1c69d4877579438d48a8ad8dc778 -->
+
+<!-- START_55f321056bfc0de7269ac70e24eb84be -->
+## api/withMultipleResponseTagsAndStatusCode
+> Example request:
+
+```bash
+curl -X POST \
+    "http://localhost/api/withMultipleResponseTagsAndStatusCode" \
+    -H "Authorization: customAuthToken" \
+    -H "Custom-Header: NotSoCustom" \
+    -H "Content-Type: application/json" \
+    -H "Accept: application/json"
+```
 
-$.ajax(settings).done(function (response) {
-    console.log(response);
-});
+```javascript
+const url = new URL(
+    "http://localhost/api/withMultipleResponseTagsAndStatusCode"
+);
+
+let headers = {
+    "Authorization": "customAuthToken",
+    "Custom-Header": "NotSoCustom",
+    "Content-Type": "application/json",
+    "Accept": "application/json",
+};
+
+fetch(url, {
+    method: "POST",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
 ```
 
-> Example response:
+
+> Example response (200):
 
 ```json
-null
+{
+    "id": 4,
+    "name": "banana",
+    "color": "red",
+    "weight": "1 kg",
+    "delicious": true,
+    "multipleResponseTagsAndStatusCodes": true
+}
+```
+> Example response (401):
+
+```json
+{
+    "message": "Unauthorized"
+}
 ```
 
 ### HTTP Request
-`GET api/test`
+`POST api/withMultipleResponseTagsAndStatusCode`
+
 
+<!-- END_55f321056bfc0de7269ac70e24eb84be -->
 
-<!-- END_0bef4e738c9d6720ad43b062015d1078 -->
+#Other😎
 
-<!-- START_960a1b2b0f0f4dde8ce993307397f9c4 -->
-## api/fetch
 
+<!-- START_c41db6ac2b427d8c29802195746cd91e -->
+## api/withEloquentApiResourceCollectionClass
 > Example request:
 
 ```bash
-curl -X GET -G "http://localhost/api/fetch" \
+curl -X GET \
+    -G "http://localhost/api/withEloquentApiResourceCollectionClass" \
+    -H "Authorization: customAuthToken" \
+    -H "Custom-Header: NotSoCustom" \
+    -H "Content-Type: application/json" \
     -H "Accept: application/json"
 ```
 
 ```javascript
-var settings = {
-    "async": true,
-    "crossDomain": true,
-    "url": "http://localhost/api/fetch",
-    "method": "GET",
-    "headers": {
-        "accept": "application/json"
+const url = new URL(
+    "http://localhost/api/withEloquentApiResourceCollectionClass"
+);
+
+let headers = {
+    "Authorization": "customAuthToken",
+    "Custom-Header": "NotSoCustom",
+    "Content-Type": "application/json",
+    "Accept": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
+```
+
+
+> Example response (200):
+
+```json
+{
+    "data": [
+        {
+            "id": 4,
+            "name": "Tested Again",
+            "email": "a@b.com"
+        },
+        {
+            "id": 4,
+            "name": "Tested Again",
+            "email": "a@b.com"
+        }
+    ],
+    "links": {
+        "self": "link-value"
     }
 }
+```
+
+### HTTP Request
+`GET api/withEloquentApiResourceCollectionClass`
+
 
-$.ajax(settings).done(function (response) {
-    console.log(response);
-});
+<!-- END_c41db6ac2b427d8c29802195746cd91e -->
+
+<!-- START_33e62c07bc6d7286628b18c0e046ebea -->
+## api/echoesUrlParameters/{param}-{param2}/{param3?}
+> Example request:
+
+```bash
+curl -X GET \
+    -G "http://localhost/api/echoesUrlParameters/4-consequatur/?something=consequatur" \
+    -H "Authorization: customAuthToken" \
+    -H "Custom-Header: NotSoCustom" \
+    -H "Content-Type: application/json" \
+    -H "Accept: application/json"
 ```
 
-> Example response:
+```javascript
+const url = new URL(
+    "http://localhost/api/echoesUrlParameters/4-consequatur/"
+);
+
+let params = {
+    "something": "consequatur",
+};
+Object.keys(params)
+    .forEach(key => url.searchParams.append(key, params[key]));
+
+let headers = {
+    "Authorization": "customAuthToken",
+    "Custom-Header": "NotSoCustom",
+    "Content-Type": "application/json",
+    "Accept": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
+```
+
+
+> Example response (200):
 
 ```json
 {
-    "id": 1,
-    "name": "Banana",
-    "color": "Red",
-    "weight": "300 grams",
-    "delicious": true
+    "param": "4",
+    "param2": "consequatur",
+    "param3": null,
+    "param4": null
 }
 ```
 
 ### HTTP Request
-`GET api/fetch`
+`GET api/echoesUrlParameters/{param}-{param2}/{param3?}`
+
+#### URL Parameters
+
+Parameter | Status | Description
+--------- | ------- | ------- | -------
+    `param` |  required  | 
+    `param2` |  optional  | 
+    `param4` |  optional  | 
+#### Query Parameters
 
+Parameter | Status | Description
+--------- | ------- | ------- | -----------
+    `something` |  optional  | 
 
-<!-- END_960a1b2b0f0f4dde8ce993307397f9c4 -->
+<!-- END_33e62c07bc6d7286628b18c0e046ebea -->
 
 
diff --git a/tests/Fixtures/partial_resource_index.md b/tests/Fixtures/partial_resource_index.md
index 25400b90..5fd1c6d0 100644
--- a/tests/Fixtures/partial_resource_index.md
+++ b/tests/Fixtures/partial_resource_index.md
@@ -21,33 +21,39 @@ Welcome to the generated API reference.
 <!-- END_INFO -->
 
 #general
-<!-- START_2b6e5a4b188cb183c7e59558cce36cb6 -->
+
+
+<!-- START_fc1e4f6a697e3c48257de845299b71d5 -->
 ## Display a listing of the resource.
 
 > Example request:
 
 ```bash
-curl -X GET -G "http://localhost/api/user" \
+curl -X GET \
+    -G "http://localhost/api/users" \
     -H "Accept: application/json"
 ```
 
 ```javascript
-var settings = {
-    "async": true,
-    "crossDomain": true,
-    "url": "http://localhost/api/user",
-    "method": "GET",
-    "headers": {
-        "accept": "application/json"
-    }
-}
-
-$.ajax(settings).done(function (response) {
-    console.log(response);
-});
+const url = new URL(
+    "http://localhost/api/users"
+);
+
+let headers = {
+    "Accept": "application/json",
+    "Content-Type": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
 ```
 
-> Example response:
+
+> Example response (200):
 
 ```json
 {
@@ -56,38 +62,42 @@ $.ajax(settings).done(function (response) {
 ```
 
 ### HTTP Request
-`GET api/user`
+`GET api/users`
 
 
-<!-- END_2b6e5a4b188cb183c7e59558cce36cb6 -->
+<!-- END_fc1e4f6a697e3c48257de845299b71d5 -->
 
-<!-- START_7f66c974d24032cb19061d55d801f62b -->
+<!-- START_5dac10bb34c7618b018b0230d4a51648 -->
 ## Show the form for creating a new resource.
 
 > Example request:
 
 ```bash
-curl -X GET -G "http://localhost/api/user/create" \
+curl -X GET \
+    -G "http://localhost/api/users/create" \
     -H "Accept: application/json"
 ```
 
 ```javascript
-var settings = {
-    "async": true,
-    "crossDomain": true,
-    "url": "http://localhost/api/user/create",
-    "method": "GET",
-    "headers": {
-        "accept": "application/json"
-    }
-}
-
-$.ajax(settings).done(function (response) {
-    console.log(response);
-});
+const url = new URL(
+    "http://localhost/api/users/create"
+);
+
+let headers = {
+    "Accept": "application/json",
+    "Content-Type": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
 ```
 
-> Example response:
+
+> Example response (200):
 
 ```json
 {
@@ -96,9 +106,9 @@ $.ajax(settings).done(function (response) {
 ```
 
 ### HTTP Request
-`GET api/user/create`
+`GET api/users/create`
 
 
-<!-- END_7f66c974d24032cb19061d55d801f62b -->
+<!-- END_5dac10bb34c7618b018b0230d4a51648 -->
 
 
diff --git a/tests/Fixtures/resource_index.md b/tests/Fixtures/resource_index.md
index c4b4676f..62e5c425 100644
--- a/tests/Fixtures/resource_index.md
+++ b/tests/Fixtures/resource_index.md
@@ -21,33 +21,39 @@ Welcome to the generated API reference.
 <!-- END_INFO -->
 
 #general
-<!-- START_2b6e5a4b188cb183c7e59558cce36cb6 -->
+
+
+<!-- START_fc1e4f6a697e3c48257de845299b71d5 -->
 ## Display a listing of the resource.
 
 > Example request:
 
 ```bash
-curl -X GET -G "http://localhost/api/user" \
+curl -X GET \
+    -G "http://localhost/api/users" \
     -H "Accept: application/json"
 ```
 
 ```javascript
-var settings = {
-    "async": true,
-    "crossDomain": true,
-    "url": "http://localhost/api/user",
-    "method": "GET",
-    "headers": {
-        "accept": "application/json"
-    }
-}
-
-$.ajax(settings).done(function (response) {
-    console.log(response);
-});
+const url = new URL(
+    "http://localhost/api/users"
+);
+
+let headers = {
+    "Accept": "application/json",
+    "Content-Type": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
 ```
 
-> Example response:
+
+> Example response (200):
 
 ```json
 {
@@ -56,38 +62,42 @@ $.ajax(settings).done(function (response) {
 ```
 
 ### HTTP Request
-`GET api/user`
+`GET api/users`
 
 
-<!-- END_2b6e5a4b188cb183c7e59558cce36cb6 -->
+<!-- END_fc1e4f6a697e3c48257de845299b71d5 -->
 
-<!-- START_7f66c974d24032cb19061d55d801f62b -->
+<!-- START_5dac10bb34c7618b018b0230d4a51648 -->
 ## Show the form for creating a new resource.
 
 > Example request:
 
 ```bash
-curl -X GET -G "http://localhost/api/user/create" \
+curl -X GET \
+    -G "http://localhost/api/users/create" \
     -H "Accept: application/json"
 ```
 
 ```javascript
-var settings = {
-    "async": true,
-    "crossDomain": true,
-    "url": "http://localhost/api/user/create",
-    "method": "GET",
-    "headers": {
-        "accept": "application/json"
-    }
-}
-
-$.ajax(settings).done(function (response) {
-    console.log(response);
-});
+const url = new URL(
+    "http://localhost/api/users/create"
+);
+
+let headers = {
+    "Accept": "application/json",
+    "Content-Type": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
 ```
 
-> Example response:
+
+> Example response (200):
 
 ```json
 {
@@ -96,190 +106,210 @@ $.ajax(settings).done(function (response) {
 ```
 
 ### HTTP Request
-`GET api/user/create`
+`GET api/users/create`
 
 
-<!-- END_7f66c974d24032cb19061d55d801f62b -->
+<!-- END_5dac10bb34c7618b018b0230d4a51648 -->
 
-<!-- START_f0654d3f2fc63c11f5723f233cc53c83 -->
+<!-- START_12e37982cc5398c7100e59625ebb5514 -->
 ## Store a newly created resource in storage.
 
 > Example request:
 
 ```bash
-curl -X POST "http://localhost/api/user" \
+curl -X POST \
+    "http://localhost/api/users" \
     -H "Accept: application/json"
 ```
 
 ```javascript
-var settings = {
-    "async": true,
-    "crossDomain": true,
-    "url": "http://localhost/api/user",
-    "method": "POST",
-    "headers": {
-        "accept": "application/json"
-    }
-}
-
-$.ajax(settings).done(function (response) {
-    console.log(response);
-});
+const url = new URL(
+    "http://localhost/api/users"
+);
+
+let headers = {
+    "Accept": "application/json",
+    "Content-Type": "application/json",
+};
+
+fetch(url, {
+    method: "POST",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
 ```
 
 
+
 ### HTTP Request
-`POST api/user`
+`POST api/users`
 
 
-<!-- END_f0654d3f2fc63c11f5723f233cc53c83 -->
+<!-- END_12e37982cc5398c7100e59625ebb5514 -->
 
-<!-- START_ceec0e0b1d13d731ad96603d26bccc2f -->
+<!-- START_8653614346cb0e3d444d164579a0a0a2 -->
 ## Display the specified resource.
 
 > Example request:
 
 ```bash
-curl -X GET -G "http://localhost/api/user/%7Buser%7D" \
+curl -X GET \
+    -G "http://localhost/api/users/1" \
     -H "Accept: application/json"
 ```
 
 ```javascript
-var settings = {
-    "async": true,
-    "crossDomain": true,
-    "url": "http://localhost/api/user/%7Buser%7D",
-    "method": "GET",
-    "headers": {
-        "accept": "application/json"
-    }
-}
-
-$.ajax(settings).done(function (response) {
-    console.log(response);
-});
+const url = new URL(
+    "http://localhost/api/users/1"
+);
+
+let headers = {
+    "Accept": "application/json",
+    "Content-Type": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
 ```
 
-> Example response:
+
+> Example response (200):
 
 ```json
 {
-    "show_resource": "1"
+    "show_resource": true
 }
 ```
 
 ### HTTP Request
-`GET api/user/{user}`
+`GET api/users/{user}`
 
 
-<!-- END_ceec0e0b1d13d731ad96603d26bccc2f -->
+<!-- END_8653614346cb0e3d444d164579a0a0a2 -->
 
-<!-- START_f4aa12af19ba08e1448d7eafc9f55e67 -->
+<!-- START_11ae28146a4d70ba9a0af9b65d290ad5 -->
 ## Show the form for editing the specified resource.
 
 > Example request:
 
 ```bash
-curl -X GET -G "http://localhost/api/user/%7Buser%7D/edit" \
+curl -X GET \
+    -G "http://localhost/api/users/1/edit" \
     -H "Accept: application/json"
 ```
 
 ```javascript
-var settings = {
-    "async": true,
-    "crossDomain": true,
-    "url": "http://localhost/api/user/%7Buser%7D/edit",
-    "method": "GET",
-    "headers": {
-        "accept": "application/json"
-    }
-}
-
-$.ajax(settings).done(function (response) {
-    console.log(response);
-});
+const url = new URL(
+    "http://localhost/api/users/1/edit"
+);
+
+let headers = {
+    "Accept": "application/json",
+    "Content-Type": "application/json",
+};
+
+fetch(url, {
+    method: "GET",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
 ```
 
-> Example response:
+
+> Example response (200):
 
 ```json
 {
-    "edit_resource": "1"
+    "edit_resource": true
 }
 ```
 
 ### HTTP Request
-`GET api/user/{user}/edit`
+`GET api/users/{user}/edit`
 
 
-<!-- END_f4aa12af19ba08e1448d7eafc9f55e67 -->
+<!-- END_11ae28146a4d70ba9a0af9b65d290ad5 -->
 
-<!-- START_a4a2abed1e8e8cad5e6a3282812fe3f3 -->
+<!-- START_48a3115be98493a3c866eb0e23347262 -->
 ## Update the specified resource in storage.
 
 > Example request:
 
 ```bash
-curl -X PUT "http://localhost/api/user/%7Buser%7D" \
+curl -X PUT \
+    "http://localhost/api/users/1" \
     -H "Accept: application/json"
 ```
 
 ```javascript
-var settings = {
-    "async": true,
-    "crossDomain": true,
-    "url": "http://localhost/api/user/%7Buser%7D",
-    "method": "PUT",
-    "headers": {
-        "accept": "application/json"
-    }
-}
-
-$.ajax(settings).done(function (response) {
-    console.log(response);
-});
+const url = new URL(
+    "http://localhost/api/users/1"
+);
+
+let headers = {
+    "Accept": "application/json",
+    "Content-Type": "application/json",
+};
+
+fetch(url, {
+    method: "PUT",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
 ```
 
 
+
 ### HTTP Request
-`PUT api/user/{user}`
+`PUT api/users/{user}`
 
-`PATCH api/user/{user}`
+`PATCH api/users/{user}`
 
 
-<!-- END_a4a2abed1e8e8cad5e6a3282812fe3f3 -->
+<!-- END_48a3115be98493a3c866eb0e23347262 -->
 
-<!-- START_4bb7fb4a7501d3cb1ed21acfc3b205a9 -->
+<!-- START_d2db7a9fe3abd141d5adbc367a88e969 -->
 ## Remove the specified resource from storage.
 
 > Example request:
 
 ```bash
-curl -X DELETE "http://localhost/api/user/%7Buser%7D" \
+curl -X DELETE \
+    "http://localhost/api/users/1" \
     -H "Accept: application/json"
 ```
 
 ```javascript
-var settings = {
-    "async": true,
-    "crossDomain": true,
-    "url": "http://localhost/api/user/%7Buser%7D",
-    "method": "DELETE",
-    "headers": {
-        "accept": "application/json"
-    }
-}
-
-$.ajax(settings).done(function (response) {
-    console.log(response);
-});
+const url = new URL(
+    "http://localhost/api/users/1"
+);
+
+let headers = {
+    "Accept": "application/json",
+    "Content-Type": "application/json",
+};
+
+fetch(url, {
+    method: "DELETE",
+    headers: headers,
+})
+    .then(response => response.json())
+    .then(json => console.log(json));
 ```
 
 
+
 ### HTTP Request
-`DELETE api/user/{user}`
+`DELETE api/users/{user}`
 
 
-<!-- END_4bb7fb4a7501d3cb1ed21acfc3b205a9 -->
+<!-- END_d2db7a9fe3abd141d5adbc367a88e969 -->
 
 
diff --git a/tests/Fixtures/response_error_test.json b/tests/Fixtures/response_error_test.json
new file mode 100644
index 00000000..5c6f264d
--- /dev/null
+++ b/tests/Fixtures/response_error_test.json
@@ -0,0 +1 @@
+{"message":"Unauthorized"}
\ No newline at end of file
diff --git a/tests/Fixtures/response_test.json b/tests/Fixtures/response_test.json
new file mode 100644
index 00000000..5a2010b7
--- /dev/null
+++ b/tests/Fixtures/response_test.json
@@ -0,0 +1 @@
+{"id":5,"name":"Jessica Jones","gender":"female"}
\ No newline at end of file
diff --git a/tests/GenerateDocumentationTest.php b/tests/GenerateDocumentationTest.php
index 07b9fe8d..595dda87 100644
--- a/tests/GenerateDocumentationTest.php
+++ b/tests/GenerateDocumentationTest.php
@@ -2,51 +2,43 @@
 
 namespace Mpociot\ApiDoc\Tests;
 
-use RecursiveIteratorIterator;
-use RecursiveDirectoryIterator;
-use Orchestra\Testbench\TestCase;
-use Illuminate\Contracts\Console\Kernel;
-use Dingo\Api\Provider\LaravelServiceProvider;
-use Mpociot\ApiDoc\Generators\LaravelGenerator;
-use Mpociot\ApiDoc\Tests\Fixtures\TestController;
-use Mpociot\ApiDoc\ApiDocGeneratorServiceProvider;
+use Illuminate\Support\Facades\App;
+use Illuminate\Support\Facades\Config;
 use Illuminate\Support\Facades\Route as RouteFacade;
-use Mpociot\ApiDoc\Tests\Fixtures\DingoTestController;
+use Illuminate\Support\Str;
+use Mpociot\ApiDoc\ApiDocGeneratorServiceProvider;
+use Mpociot\ApiDoc\Tests\Fixtures\TestController;
+use Mpociot\ApiDoc\Tests\Fixtures\TestGroupController;
+use Mpociot\ApiDoc\Tests\Fixtures\TestPartialResourceController;
 use Mpociot\ApiDoc\Tests\Fixtures\TestResourceController;
+use Mpociot\ApiDoc\Tests\Fixtures\TestUser;
+use Mpociot\ApiDoc\Tools\Utils;
+use Orchestra\Testbench\TestCase;
+use ReflectionException;
 
 class GenerateDocumentationTest extends TestCase
 {
-    /**
-     * @var \Mpociot\ApiDoc\AbstractGenerator
-     */
-    protected $generator;
+    use TestHelpers;
 
-    /**
-     * Setup the test environment.
-     */
-    public function setUp()
+    protected function setUp(): void
     {
         parent::setUp();
 
-        $this->generator = new LaravelGenerator();
+        $factory = app(\Illuminate\Database\Eloquent\Factory::class);
+        $factory->define(TestUser::class, function () {
+            return [
+                'id' => 4,
+                'first_name' => 'Tested',
+                'last_name' => 'Again',
+                'email' => 'a@b.com',
+            ];
+        });
     }
 
-    public function tearDown()
+    public function tearDown(): void
     {
-        // delete the generated docs - compatible cross-platform
-        $dir = __DIR__.'/../public/docs';
-        if (is_dir($dir)) {
-            $files = new RecursiveIteratorIterator(
-                new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS),
-                RecursiveIteratorIterator::CHILD_FIRST
-            );
-
-            foreach ($files as $fileinfo) {
-                $todo = ($fileinfo->isDir() ? 'rmdir' : 'unlink');
-                $todo($fileinfo->getRealPath());
-            }
-            rmdir($dir);
-        }
+        Utils::deleteDirectoryAndContents('/public/docs');
+        Utils::deleteDirectoryAndContents('/resources/docs');
     }
 
     /**
@@ -57,247 +49,374 @@ public function tearDown()
     protected function getPackageProviders($app)
     {
         return [
-            LaravelServiceProvider::class,
             ApiDocGeneratorServiceProvider::class,
         ];
     }
 
-    public function testConsoleCommandNeedsPrefixesOrDomainsOrRoutes()
+    /** @test */
+    public function console_command_does_not_work_with_closure()
     {
-        $output = $this->artisan('api:generate');
-        $this->assertEquals('You must provide either a route prefix, a route domain, a route or a middleware to generate the documentation.'.PHP_EOL, $output);
+        RouteFacade::get('/api/closure', function () {
+            return 'hi';
+        });
+        RouteFacade::get('/api/test', TestController::class . '@withEndpointDescription');
+
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        $output = $this->artisan('apidoc:generate');
+
+        $this->assertStringContainsString('Skipping route: [GET] api/closure', $output);
+        $this->assertStringContainsString('Processed route: [GET] api/test', $output);
     }
 
-    public function testConsoleCommandDoesNotWorkWithClosure()
+    /** @test */
+    public function console_command_works_with_routes_callable_tuple()
     {
-        RouteFacade::get('/api/closure', function () {
-            return 'foo';
-        });
-        RouteFacade::get('/api/test', TestController::class.'@parseMethodDescription');
+        RouteFacade::get('/api/array/test', [TestController::class, 'withEndpointDescription']);
 
-        $output = $this->artisan('api:generate', [
-            '--routePrefix' => 'api/*',
-        ]);
-        $this->assertContains('Skipping route: [GET] api/closure', $output);
-        $this->assertContains('Processed route: [GET] api/test', $output);
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        $output = $this->artisan('apidoc:generate');
+
+        $this->assertStringNotContainsString('Skipping route: [GET] api/array/test', $output);
+        $this->assertStringContainsString('Processed route: [GET] api/array/test', $output);
     }
 
-    public function testConsoleCommandDoesNotWorkWithClosureUsingDingo()
+    /** @test */
+    public function can_skip_single_routes()
     {
-        if (version_compare($this->app->version(), '5.4', '>=')) {
-            $this->markTestSkipped('Dingo does not support Laravel 5.4');
-        }
+        RouteFacade::get('/api/skip', TestController::class . '@skip');
+        RouteFacade::get('/api/test', TestController::class . '@withEndpointDescription');
 
-        $api = app('Dingo\Api\Routing\Router');
-        $api->version('v1', function ($api) {
-            $api->get('/closure', function () {
-                return 'foo';
-            });
-            $api->get('/test', DingoTestController::class.'@parseMethodDescription');
-
-            $output = $this->artisan('api:generate', [
-                '--router' => 'dingo',
-                '--routePrefix' => 'v1',
-            ]);
-            $this->assertContains('Skipping route: [GET] closure', $output);
-            $this->assertContains('Processed route: [GET] test', $output);
-        });
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        $output = $this->artisan('apidoc:generate');
+
+        $this->assertStringContainsString('Skipping route: [GET] api/skip', $output);
+        $this->assertStringContainsString('Processed route: [GET] api/test', $output);
     }
 
-    public function testCanSkipSingleRoutesCommandDoesNotWorkWithClosure()
+    /** @test */
+    public function can_skip_non_existent_response_files()
     {
-        RouteFacade::get('/api/skip', TestController::class.'@skip');
-        RouteFacade::get('/api/test', TestController::class.'@parseMethodDescription');
+        RouteFacade::get('/api/non-existent', TestController::class . '@withNonExistentResponseFile');
 
-        $output = $this->artisan('api:generate', [
-            '--routePrefix' => 'api/*',
-        ]);
-        $this->assertContains('Skipping route: [GET] api/skip', $output);
-        $this->assertContains('Processed route: [GET] api/test', $output);
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        $output = $this->artisan('apidoc:generate');
+
+        $this->assertStringContainsString('Skipping route: [GET] api/non-existent', $output);
+        $this->assertStringContainsString('@responseFile i-do-not-exist.json does not exist', $output);
     }
 
-    public function testCanParseResourceRoutes()
+    /** @test */
+    public function can_parse_resource_routes()
     {
-        RouteFacade::resource('/api/user', TestResourceController::class);
-        $output = $this->artisan('api:generate', [
-            '--routePrefix' => 'api/*',
+        RouteFacade::resource('/api/users', TestResourceController::class);
+
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        config([
+            'apidoc.routes.0.apply.headers' => [
+                'Accept' => 'application/json',
+            ],
         ]);
-        $fixtureMarkdown = __DIR__.'/Fixtures/resource_index.md';
-        $generatedMarkdown = __DIR__.'/../public/docs/source/index.md';
+
+        $this->artisan('apidoc:generate');
+
+        $fixtureMarkdown = __DIR__ . '/Fixtures/resource_index.md';
+        $generatedMarkdown = __DIR__ . '/../resources/docs/source/index.md';
         $this->assertFilesHaveSameContent($fixtureMarkdown, $generatedMarkdown);
     }
 
-    public function testCanParsePartialResourceRoutes()
+    /** @test */
+    public function can_parse_partial_resource_routes()
     {
-        RouteFacade::resource('/api/user', TestResourceController::class, [
-            'only' => [
-                'index', 'create',
+        RouteFacade::resource('/api/users', TestResourceController::class)
+                ->only(['index', 'create']);
+
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        config([
+            'apidoc.routes.0.apply.headers' => [
+                'Accept' => 'application/json',
             ],
         ]);
-        $output = $this->artisan('api:generate', [
-            '--routePrefix' => 'api/*',
-        ]);
-        $fixtureMarkdown = __DIR__.'/Fixtures/partial_resource_index.md';
-        $generatedMarkdown = __DIR__.'/../public/docs/source/index.md';
+
+        $this->artisan('apidoc:generate');
+
+        $fixtureMarkdown = __DIR__ . '/Fixtures/partial_resource_index.md';
+        $generatedMarkdown = __DIR__ . '/../resources/docs/source/index.md';
         $this->assertFilesHaveSameContent($fixtureMarkdown, $generatedMarkdown);
 
-        RouteFacade::apiResource('/api/user', TestResourceController::class, [
-            'only' => [
-                'index', 'create',
-            ],
-        ]);
-        $output = $this->artisan('api:generate', [
-            '--routePrefix' => 'api/*',
-        ]);
-        $fixtureMarkdown = __DIR__.'/Fixtures/partial_resource_index.md';
-        $generatedMarkdown = __DIR__.'/../public/docs/source/index.md';
+        RouteFacade::apiResource('/api/users', TestResourceController::class)
+                ->only(['index', 'create']);
+
+        $this->artisan('apidoc:generate');
+
+        $fixtureMarkdown = __DIR__ . '/Fixtures/partial_resource_index.md';
+        $generatedMarkdown = __DIR__ . '/../resources/docs/source/index.md';
         $this->assertFilesHaveSameContent($fixtureMarkdown, $generatedMarkdown);
     }
 
-    public function testGeneratedMarkdownFileIsCorrect()
+    /** @test */
+    public function generated_markdown_file_is_correct()
     {
-        RouteFacade::get('/api/test', TestController::class.'@parseMethodDescription');
-        RouteFacade::get('/api/fetch', TestController::class.'@fetchRouteResponse');
-
-        $output = $this->artisan('api:generate', [
-            '--routePrefix' => 'api/*',
+        RouteFacade::get('/api/withDescription', [TestController::class, 'withEndpointDescription']);
+        RouteFacade::get('/api/withResponseTag', TestController::class . '@withResponseTag');
+        RouteFacade::get('/api/withBodyParameters', TestController::class . '@withBodyParameters');
+        RouteFacade::get('/api/withQueryParameters', TestController::class . '@withQueryParameters');
+        RouteFacade::get('/api/withAuthTag', TestController::class . '@withAuthenticatedTag');
+        RouteFacade::get('/api/withEloquentApiResource', [TestController::class, 'withEloquentApiResource']);
+        RouteFacade::get('/api/withEloquentApiResourceCollectionClass', [TestController::class, 'withEloquentApiResourceCollectionClass']);
+        RouteFacade::post('/api/withMultipleResponseTagsAndStatusCode', [TestController::class, 'withMultipleResponseTagsAndStatusCode']);
+        RouteFacade::get('/api/echoesUrlParameters/{param}-{param2}/{param3?}', [TestController::class, 'echoesUrlParameters']);
+
+        // We want to have the same values for params each time
+        config(['apidoc.type' => 'static']);
+        config(['apidoc.faker_seed' => 1234]);
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        config([
+            'apidoc.routes.0.apply.headers' => [
+                'Authorization' => 'customAuthToken',
+                'Custom-Header' => 'NotSoCustom',
+                'Content-Type' => 'application/json',
+                'Accept' => 'application/json',
+            ],
         ]);
+        $this->artisan('apidoc:generate');
+
+        $generatedMarkdown = __DIR__ . '/../resources/docs/source/index.md';
+        $compareMarkdown = __DIR__ . '/../resources/docs/source/.compare.md';
+        $fixtureMarkdown = __DIR__ . '/Fixtures/index.md';
 
-        $generatedMarkdown = __DIR__.'/../public/docs/source/index.md';
-        $compareMarkdown = __DIR__.'/../public/docs/source/.compare.md';
-        $fixtureMarkdown = __DIR__.'/Fixtures/index.md';
         $this->assertFilesHaveSameContent($fixtureMarkdown, $generatedMarkdown);
         $this->assertFilesHaveSameContent($fixtureMarkdown, $compareMarkdown);
     }
 
-    public function testCanPrependAndAppendDataToGeneratedMarkdown()
+    /** @test */
+    public function can_prepend_and_append_data_to_generated_markdown()
     {
-        RouteFacade::get('/api/test', TestController::class.'@parseMethodDescription');
-        RouteFacade::get('/api/fetch', TestController::class.'@fetchRouteResponse');
+        RouteFacade::get('/api/test', TestController::class . '@withEndpointDescription');
+        RouteFacade::get('/api/responseTag', TestController::class . '@withResponseTag');
 
-        $this->artisan('api:generate', [
-            '--routePrefix' => 'api/*',
-        ]);
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        $this->artisan('apidoc:generate');
 
-        $prependMarkdown = __DIR__.'/Fixtures/prepend.md';
-        $appendMarkdown = __DIR__.'/Fixtures/append.md';
-        copy($prependMarkdown, __DIR__.'/../public/docs/source/prepend.md');
-        copy($appendMarkdown, __DIR__.'/../public/docs/source/append.md');
+        $prependMarkdown = __DIR__ . '/Fixtures/prepend.md';
+        $appendMarkdown = __DIR__ . '/Fixtures/append.md';
+        copy($prependMarkdown, __DIR__ . '/../resources/docs/source/prepend.md');
+        copy($appendMarkdown, __DIR__ . '/../resources/docs/source/append.md');
 
-        $this->artisan('api:generate', [
-            '--routePrefix' => 'api/*',
-        ]);
+        $this->artisan('apidoc:generate');
 
-        $generatedMarkdown = __DIR__.'/../public/docs/source/index.md';
-        $this->assertContainsRaw($this->getFileContents($prependMarkdown), $this->getFileContents($generatedMarkdown));
-        $this->assertContainsRaw($this->getFileContents($appendMarkdown), $this->getFileContents($generatedMarkdown));
+        $generatedMarkdown = __DIR__ . '/../resources/docs/source/index.md';
+        $this->assertContainsIgnoringWhitespace($this->getFileContents($prependMarkdown), $this->getFileContents($generatedMarkdown));
+        $this->assertContainsIgnoringWhitespace($this->getFileContents($appendMarkdown), $this->getFileContents($generatedMarkdown));
     }
 
-    public function testAddsBindingsToGetRouteRules()
+    /** @test */
+    public function generated_postman_collection_file_is_correct()
     {
-        RouteFacade::get('/api/test/{foo}', TestController::class.'@addRouteBindingsToRequestClass');
-
-        $this->artisan('api:generate', [
-            '--routePrefix' => 'api/*',
-            '--bindings' => 'foo,bar',
+        RouteFacade::get('/api/withDescription', [TestController::class, 'withEndpointDescription']);
+        RouteFacade::get('/api/withResponseTag', TestController::class . '@withResponseTag');
+        RouteFacade::post('/api/withBodyParameters', TestController::class . '@withBodyParameters');
+        RouteFacade::get('/api/withQueryParameters', TestController::class . '@withQueryParameters');
+        RouteFacade::get('/api/withAuthTag', TestController::class . '@withAuthenticatedTag');
+        RouteFacade::get('/api/withEloquentApiResource', [TestController::class, 'withEloquentApiResource']);
+        RouteFacade::get('/api/withEloquentApiResourceCollectionClass', [TestController::class, 'withEloquentApiResourceCollectionClass']);
+        RouteFacade::post('/api/withMultipleResponseTagsAndStatusCode', [TestController::class, 'withMultipleResponseTagsAndStatusCode']);
+        RouteFacade::get('/api/echoesUrlParameters/{param}-{param2}/{param3?}', [TestController::class, 'echoesUrlParameters']);
+
+        // We want to have the same values for params each time
+        config(['apidoc.faker_seed' => 1234]);
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        config([
+            'apidoc.routes.0.apply.headers' => [
+                'Authorization' => 'customAuthToken',
+                'Custom-Header' => 'NotSoCustom',
+                'Accept' => 'application/json',
+                'Content-Type' => 'application/json',
+            ],
         ]);
 
-        $generatedMarkdown = file_get_contents(__DIR__.'/../public/docs/source/index.md');
+        $this->artisan('apidoc:generate');
 
-        $this->assertContains('Not in: `bar`', $generatedMarkdown);
+        $generatedCollection = json_decode(file_get_contents(__DIR__ . '/../public/docs/collection.json'), true);
+        // The Postman ID varies from call to call; erase it to make the test data reproducible.
+        $generatedCollection['info']['_postman_id'] = '';
+        $fixtureCollection = json_decode(file_get_contents(__DIR__ . '/Fixtures/collection.json'), true);
+        $this->assertEquals($fixtureCollection, $generatedCollection);
     }
 
-    public function testGeneratedPostmanCollectionFileIsCorrect()
+    /** @test */
+    public function generated_postman_collection_domain_is_correct()
     {
-        RouteFacade::get('/api/test', TestController::class.'@parseMethodDescription');
-        RouteFacade::post('/api/fetch', TestController::class.'@fetchRouteResponse');
+        $domain = 'http://somedomain.test/';
+        RouteFacade::get('/api/test', TestController::class . '@withEndpointDescription');
 
-        $output = $this->artisan('api:generate', [
-            '--routePrefix' => 'api/*',
-        ]);
+        config(['apidoc.base_url' => $domain]);
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        $this->artisan('apidoc:generate');
 
-        $generatedCollection = json_decode(file_get_contents(__DIR__.'/../public/docs/collection.json'));
-        $generatedCollection->info->_postman_id = '';
+        $generatedCollection = json_decode(file_get_contents(__DIR__ . '/../public/docs/collection.json'));
+        $endpointUrl = $generatedCollection->item[0]->item[0]->request->url->host;
+        $this->assertTrue(Str::startsWith($endpointUrl, 'somedomain.test'));
+    }
 
-        $fixtureCollection = json_decode(file_get_contents(__DIR__.'/Fixtures/collection.json'));
-        $this->assertEquals($generatedCollection, $fixtureCollection);
+    /** @test */
+    public function generated_postman_collection_can_have_custom_url()
+    {
+        Config::set('apidoc.base_url', 'http://yourapp.app/');
+        RouteFacade::get('/api/test', TestController::class . '@withEndpointDescription');
+        RouteFacade::post('/api/responseTag', TestController::class . '@withResponseTag');
+
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        $this->artisan('apidoc:generate');
+
+        $generatedCollection = json_decode(file_get_contents(__DIR__ . '/../public/docs/collection.json'), true);
+        // The Postman ID varies from call to call; erase it to make the test data reproducible.
+        $generatedCollection['info']['_postman_id'] = '';
+        $fixtureCollection = json_decode(file_get_contents(__DIR__ . '/Fixtures/collection_custom_url.json'), true);
+        $this->assertEquals($fixtureCollection, $generatedCollection);
     }
 
-    public function testCanAppendCustomHttpHeaders()
+    /** @test */
+    public function generated_postman_collection_can_have_secure_url()
     {
-        RouteFacade::get('/api/headers', TestController::class.'@checkCustomHeaders');
+        Config::set('apidoc.base_url', 'https://yourapp.app/');
+        RouteFacade::get('/api/test', TestController::class . '@withEndpointDescription');
+        RouteFacade::post('/api/responseTag', TestController::class . '@withResponseTag');
+
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        $this->artisan('apidoc:generate');
+
+        $generatedCollection = json_decode(file_get_contents(__DIR__ . '/../public/docs/collection.json'), true);
+        // The Postman ID varies from call to call; erase it to make the test data reproducible.
+        $generatedCollection['info']['_postman_id'] = '';
+        $fixtureCollection = json_decode(file_get_contents(__DIR__ . '/Fixtures/collection_with_secure_url.json'), true);
+        $this->assertEquals($fixtureCollection, $generatedCollection);
+    }
 
-        $output = $this->artisan('api:generate', [
-            '--routePrefix' => 'api/*',
-            '--header' => [
-                'Authorization: customAuthToken',
-                'X-Custom-Header: foobar',
+    /** @test */
+    public function generated_postman_collection_can_append_custom_http_headers()
+    {
+        RouteFacade::get('/api/headers', TestController::class . '@checkCustomHeaders');
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        config([
+            'apidoc.routes.0.apply.headers' => [
+                'Authorization' => 'customAuthToken',
+                'Custom-Header' => 'NotSoCustom',
             ],
         ]);
+        $this->artisan('apidoc:generate');
 
-        $generatedMarkdown = $this->getFileContents(__DIR__.'/../public/docs/source/index.md');
-        $this->assertContainsRaw('"authorization": [
-        "customAuthToken"
-    ],
-    "x-custom-header": [
-        "foobar"
-    ]', $generatedMarkdown);
+        $generatedCollection = json_decode(file_get_contents(__DIR__ . '/../public/docs/collection.json'), true);
+        // The Postman ID varies from call to call; erase it to make the test data reproducible.
+        $generatedCollection['info']['_postman_id'] = '';
+        $fixtureCollection = json_decode(file_get_contents(__DIR__ . '/Fixtures/collection_with_custom_headers.json'), true);
+        $this->assertEquals($fixtureCollection, $generatedCollection);
     }
 
-    public function testGeneratesUTF8Responses()
+    /** @test */
+    public function generated_postman_collection_can_have_query_parameters()
     {
-        RouteFacade::get('/api/utf8', TestController::class.'@utf8');
-
-        $output = $this->artisan('api:generate', [
-            '--routePrefix' => 'api/*',
-        ]);
+        RouteFacade::get('/api/withQueryParameters', TestController::class . '@withQueryParameters');
+        // We want to have the same values for params each time
+        config(['apidoc.faker_seed' => 1234]);
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        $this->artisan('apidoc:generate');
+
+        $generatedCollection = json_decode(file_get_contents(__DIR__ . '/../public/docs/collection.json'), true);
+        // The Postman ID varies from call to call; erase it to make the test data reproducible.
+        $generatedCollection['info']['_postman_id'] = '';
+        $fixtureCollection = json_decode(file_get_contents(__DIR__ . '/Fixtures/collection_with_query_parameters.json'), true);
+        $this->assertEquals($fixtureCollection, $generatedCollection);
+    }
 
-        $generatedMarkdown = file_get_contents(__DIR__.'/../public/docs/source/index.md');
-        $this->assertContains('Лорем ипсум долор сит амет', $generatedMarkdown);
+    /** @test */
+    public function generated_postman_collection_can_add_body_parameters()
+    {
+        RouteFacade::get('/api/withBodyParameters', TestController::class . '@withBodyParameters');
+        // We want to have the same values for params each time
+        config(['apidoc.faker_seed' => 1234]);
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        $this->artisan('apidoc:generate');
+
+        $generatedCollection = json_decode(file_get_contents(__DIR__ . '/../public/docs/collection.json'), true);
+        // The Postman ID varies from call to call; erase it to make the test data reproducible.
+        $generatedCollection['info']['_postman_id'] = '';
+        $fixtureCollection = json_decode(file_get_contents(__DIR__ . '/Fixtures/collection_with_body_parameters.json'), true);
+        $this->assertEquals($fixtureCollection, $generatedCollection);
     }
 
-    /**
-     * @param string $command
-     * @param array $parameters
-     *
-     * @return mixed
-     */
-    public function artisan($command, $parameters = [])
+    /** @test */
+    public function can_append_custom_http_headers()
     {
-        $this->app[Kernel::class]->call($command, $parameters);
+        RouteFacade::get('/api/headers', TestController::class . '@checkCustomHeaders');
 
-        return $this->app[Kernel::class]->output();
+        config(['apidoc.routes.0.match.prefixes' => ['api/*']]);
+        config([
+            'apidoc.routes.0.apply.headers' => [
+                'Authorization' => 'customAuthToken',
+                'Custom-Header' => 'NotSoCustom',
+            ],
+        ]);
+        $this->artisan('apidoc:generate');
+
+        $generatedMarkdown = $this->getFileContents(__DIR__ . '/../resources/docs/source/index.md');
+        $this->assertContainsIgnoringWhitespace('"Authorization": "customAuthToken","Custom-Header":"NotSoCustom"', $generatedMarkdown);
     }
 
-    private function assertFilesHaveSameContent($pathToExpected, $pathToActual)
+    /** @test */
+    public function can_parse_utf8_response()
     {
-        $actual = $this->getFileContents($pathToActual);
-        $expected = $this->getFileContents($pathToExpected);
-        $this->assertSame($expected, $actual);
+        RouteFacade::get('/api/utf8', TestController::class . '@withUtf8ResponseTag');
+
+        config(['apidoc.routes.0.prefixes' => ['api/*']]);
+        $this->artisan('apidoc:generate');
+
+        $generatedMarkdown = file_get_contents(__DIR__ . '/../resources/docs/source/index.md');
+        $this->assertStringContainsString('Лорем ипсум долор сит амет', $generatedMarkdown);
     }
 
-    /**
-     * Get the contents of a file in a cross-platform-compatible way.
-     *
-     * @param $path
-     *
-     * @return string
-     */
-    private function getFileContents($path)
+    /** @test */
+    public function sorts_group_naturally()
     {
-        return str_replace("\r\n", "\n", file_get_contents($path));
+        RouteFacade::get('/api/action1', TestGroupController::class . '@action1');
+        RouteFacade::get('/api/action1b', TestGroupController::class . '@action1b');
+        RouteFacade::get('/api/action2', TestGroupController::class . '@action2');
+        RouteFacade::get('/api/action10', TestGroupController::class . '@action10');
+
+        config(['apidoc.routes.0.prefixes' => ['api/*']]);
+        $this->artisan('apidoc:generate');
+        $generatedMarkdown = file_get_contents(__DIR__ . '/../resources/docs/source/index.md');
+
+        $firstGroup1Occurrence = strpos($generatedMarkdown, '#1. Group 1');
+        $firstGroup2Occurrence = strpos($generatedMarkdown, '#2. Group 2');
+        $firstGroup10Occurrence = strpos($generatedMarkdown, '#10. Group 10');
+
+        $this->assertNotFalse($firstGroup1Occurrence);
+        $this->assertNotFalse($firstGroup2Occurrence);
+        $this->assertNotFalse($firstGroup2Occurrence);
+
+        $this->assertTrue(
+            $firstGroup1Occurrence < $firstGroup2Occurrence && $firstGroup2Occurrence < $firstGroup10Occurrence
+        );
     }
 
-    /**
-     * Assert that a string contains another string, ignoring all whitespace.
-     *
-     * @param $needle
-     * @param $haystack
-     */
-    private function assertContainsRaw($needle, $haystack)
+    /** @test */
+    public function supports_partial_resource_controller()
     {
-        $haystack = preg_replace('/\s/', '', $haystack);
-        $needle = preg_replace('/\s/', '', $needle);
-        $this->assertContains($needle, $haystack);
+        RouteFacade::resource('/api/partial', TestPartialResourceController::class);
+
+        config(['apidoc.routes.0.prefixes' => ['api/*']]);
+
+        $thrownException = null;
+
+        try {
+            $this->artisan('apidoc:generate');
+        } catch (ReflectionException $e) {
+            $thrownException = $e;
+        }
+
+        $this->assertNull($thrownException);
+        $generatedMarkdown = file_get_contents(__DIR__ . '/../resources/docs/source/index.md');
+        $this->assertStringContainsString('Group A', $generatedMarkdown);
+        $this->assertStringContainsString('Group B', $generatedMarkdown);
     }
 }
diff --git a/tests/RuleDescriptionParserTest.php b/tests/RuleDescriptionParserTest.php
deleted file mode 100644
index f1f6f724..00000000
--- a/tests/RuleDescriptionParserTest.php
+++ /dev/null
@@ -1,118 +0,0 @@
-<?php
-
-namespace Mpociot\ApiDoc\Tests;
-
-use Mockery as m;
-use Orchestra\Testbench\TestCase;
-use Illuminate\Translation\Translator;
-use Illuminate\Translation\LoaderInterface;
-use Mpociot\ApiDoc\Parsers\RuleDescriptionParser;
-use Mpociot\ApiDoc\ApiDocGeneratorServiceProvider;
-
-class RuleDescriptionParserTest extends TestCase
-{
-    protected $translatorMock;
-
-    public function setUp()
-    {
-        parent::setUp();
-        $fileLoaderMock = m::mock(LoaderInterface::class);
-        $this->translatorMock = m::mock(Translator::class, [$fileLoaderMock, 'es']);
-        $this->app->instance('translator', $this->translatorMock);
-    }
-
-    public function tearDown()
-    {
-        m::close();
-    }
-
-    public function testReturnsAnEmptyDescriptionIfARuleIsNotParsed()
-    {
-        $this->translatorMock->shouldReceive('hasForLocale')->twice()->andReturn(false);
-
-        $description = new RuleDescriptionParser();
-
-        $this->assertEmpty($description->getDescription());
-    }
-
-    public function testProvidesANamedContructor()
-    {
-        $this->assertInstanceOf(RuleDescriptionParser::class, RuleDescriptionParser::parse());
-    }
-
-    public function testReturnsADescriptionInMainLanguageIfAvailable()
-    {
-        $this->translatorMock->shouldReceive('hasForLocale')->twice()->with('apidoc::rules.alpha')->andReturn(true);
-        $this->translatorMock->shouldReceive('get')->once()->with('apidoc::rules.alpha')->andReturn('Solo caracteres alfabeticos permitidos');
-
-        $description = RuleDescriptionParser::parse('alpha')->getDescription();
-
-        $this->assertEquals('Solo caracteres alfabeticos permitidos', $description);
-    }
-
-    public function testReturnsDescriptionInDefaultLanguageIfNotAvailableInMainLanguage()
-    {
-        $this->translatorMock->shouldReceive('hasForLocale')->twice()->with('apidoc::rules.alpha')->andReturn(false);
-        $this->translatorMock->shouldReceive('hasForLocale')->once()->with('apidoc::rules.alpha', 'en')->andReturn(true);
-        $this->translatorMock->shouldReceive('get')->once()->with('apidoc::rules.alpha', [], 'en')->andReturn('Only alphabetic characters allowed');
-
-        $description = RuleDescriptionParser::parse('alpha')->getDescription();
-
-        $this->assertEquals('Only alphabetic characters allowed', $description);
-    }
-
-    public function testReturnsAnEmptyDescriptionIfNotAvailable()
-    {
-        $this->translatorMock->shouldReceive('hasForLocale')->once()->with('apidoc::rules.dummy_rule')->andReturn(false);
-        $this->translatorMock->shouldReceive('hasForLocale')->once()->with('apidoc::rules.dummy_rule', 'en')->andReturn(false);
-
-        $description = RuleDescriptionParser::parse('dummy_rule')->getDescription();
-
-        $this->assertEmpty($description);
-    }
-
-    public function testAllowsToPassParametersToTheDescription()
-    {
-        $this->translatorMock->shouldReceive('hasForLocale')->twice()->with('apidoc::rules.digits')->andReturn(false);
-        $this->translatorMock->shouldReceive('hasForLocale')->once()->with('apidoc::rules.digits', 'en')->andReturn(true);
-        $this->translatorMock->shouldReceive('get')->once()->with('apidoc::rules.digits', [], 'en')->andReturn('Must have an exact length of `:attribute`');
-
-        $description = RuleDescriptionParser::parse('digits')->with(2)->getDescription();
-
-        $this->assertEquals('Must have an exact length of `2`', $description);
-    }
-
-    public function testAllowsToPassMultipleParametersToTheDescription()
-    {
-        $this->translatorMock->shouldReceive('hasForLocale')->twice()->with('apidoc::rules.required_if')->andReturn(false);
-        $this->translatorMock->shouldReceive('hasForLocale')->once()->with('apidoc::rules.required_if', 'en')->andReturn(true);
-        $this->translatorMock->shouldReceive('get')->once()->with('apidoc::rules.required_if', [], 'en')->andReturn('Required if `:attribute` is `:attribute`');
-
-        $description = RuleDescriptionParser::parse('required_if')->with(['2 + 2', 4])->getDescription();
-
-        $this->assertEquals('Required if `2 + 2` is `4`', $description);
-    }
-
-    /**
-     * @param \Illuminate\Foundation\Application $app
-     *
-     * @return array
-     */
-    protected function getPackageProviders($app)
-    {
-        return [ApiDocGeneratorServiceProvider::class];
-    }
-
-    /**
-     * Define environment setup.
-     *
-     * @param  \Illuminate\Foundation\Application   $app
-     *
-     * @return void
-     */
-    protected function getEnvironmentSetUp($app)
-    {
-        $app['config']->set('app.locale', 'es'); // Just to be different from default language.
-        $app['config']->set('app.fallback_locale', 'ch'); // Just to be different from default language.
-    }
-}
diff --git a/tests/TestHelpers.php b/tests/TestHelpers.php
new file mode 100644
index 00000000..94056610
--- /dev/null
+++ b/tests/TestHelpers.php
@@ -0,0 +1,53 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests;
+
+use Illuminate\Contracts\Console\Kernel;
+
+trait TestHelpers
+{
+    /**
+     * @param string $command
+     * @param array $parameters
+     *
+     * @return mixed
+     */
+    public function artisan($command, $parameters = [])
+    {
+        $this->app[Kernel::class]->call($command, $parameters);
+
+        return $this->app[Kernel::class]->output();
+    }
+
+    private function assertFilesHaveSameContent($pathToExpected, $pathToActual)
+    {
+        $actual = $this->getFileContents($pathToActual);
+        $expected = $this->getFileContents($pathToExpected);
+        $this->assertSame($expected, $actual);
+    }
+
+    /**
+     * Get the contents of a file in a cross-platform-compatible way.
+     *
+     * @param $path
+     *
+     * @return string
+     */
+    private function getFileContents($path)
+    {
+        return str_replace("\r\n", "\n", file_get_contents($path));
+    }
+
+    /**
+     * Assert that a string contains another string, ignoring all whitespace.
+     *
+     * @param $needle
+     * @param $haystack
+     */
+    private function assertContainsIgnoringWhitespace($needle, $haystack)
+    {
+        $haystack = preg_replace('/\s/', '', $haystack);
+        $needle = preg_replace('/\s/', '', $needle);
+        $this->assertStringContainsString($needle, $haystack);
+    }
+}
diff --git a/tests/Unit/DingoGeneratorTest.php b/tests/Unit/DingoGeneratorTest.php
new file mode 100644
index 00000000..e9d690c7
--- /dev/null
+++ b/tests/Unit/DingoGeneratorTest.php
@@ -0,0 +1,52 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests\Unit;
+
+use Dingo\Api\Routing\Router;
+use Mpociot\ApiDoc\ApiDocGeneratorServiceProvider;
+use Mpociot\ApiDoc\Tests\Fixtures\TestController;
+
+/**
+ * @group dingo
+ */
+class DingoGeneratorTest extends GeneratorTestCase
+{
+    protected function getPackageProviders($app)
+    {
+        return [
+            ApiDocGeneratorServiceProvider::class,
+            \Dingo\Api\Provider\LaravelServiceProvider::class,
+        ];
+    }
+
+    public function setUp(): void
+    {
+        parent::setUp();
+
+        config(['apidoc.router' => 'dingo']);
+    }
+
+    public function createRoute(string $httpMethod, string $path, string $controllerMethod, $register = false, $class = TestController::class)
+    {
+        $route = null;
+        /** @var Router $api */
+        $api = app(Router::class);
+        $api->version('v1', function (Router $api) use ($class, $controllerMethod, $path, $httpMethod, &$route) {
+            $route = $api->$httpMethod($path, $class . "@$controllerMethod");
+        });
+
+        return $route;
+    }
+
+    public function createRouteUsesArray(string $httpMethod, string $path, string $controllerMethod, $register = false, $class = TestController::class)
+    {
+        $route = null;
+        /** @var Router $api */
+        $api = app(Router::class);
+        $api->version('v1', function (Router $api) use ($class, $controllerMethod, $path, $httpMethod, &$route) {
+            $route = $api->$httpMethod($path, [$class, $controllerMethod]);
+        });
+
+        return $route;
+    }
+}
diff --git a/tests/Unit/GeneratorPluginSystemTestCase.php b/tests/Unit/GeneratorPluginSystemTestCase.php
new file mode 100644
index 00000000..9d5bc917
--- /dev/null
+++ b/tests/Unit/GeneratorPluginSystemTestCase.php
@@ -0,0 +1,238 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests\Unit;
+
+use DMS\PHPUnitExtensions\ArraySubset\ArraySubsetAsserts;
+use Illuminate\Routing\Route;
+use Mpociot\ApiDoc\ApiDocGeneratorServiceProvider;
+use Mpociot\ApiDoc\Extracting\Generator;
+use Mpociot\ApiDoc\Extracting\Strategies\Strategy;
+use Mpociot\ApiDoc\Tests\Fixtures\TestController;
+use Mpociot\ApiDoc\Tools\DocumentationConfig;
+use ReflectionClass;
+use ReflectionMethod;
+
+class GeneratorPluginSystemTestCase extends LaravelGeneratorTest
+{
+    use ArraySubsetAsserts;
+
+    /**
+     * @var \Mpociot\ApiDoc\Extracting\Generator
+     */
+    protected $generator;
+
+    protected function getPackageProviders($app)
+    {
+        return [
+            ApiDocGeneratorServiceProvider::class,
+        ];
+    }
+
+    /** @test */
+    public function only_specified_strategies_are_loaded()
+    {
+        $config = [
+            'strategies' => [
+                'metadata' => [EmptyStrategy1::class],
+                'bodyParameters' => [
+                    EmptyStrategy1::class,
+                    EmptyStrategy2::class,
+                ],
+                'responses' => [EmptyStrategy1::class],
+            ],
+        ];
+        $route = $this->createRoute('GET', '/api/test', 'dummy', true, TestController::class);
+        $generator = new Generator(new DocumentationConfig($config));
+        $generator->processRoute($route);
+
+        // Probably not the best way to do this, but 🤷‍♂️
+        $this->assertTrue(EmptyStrategy1::$called['metadata']);
+
+        $this->assertTrue(EmptyStrategy1::$called['bodyParameters']);
+        $this->assertTrue(EmptyStrategy2::$called['bodyParameters']);
+
+        $this->assertArrayNotHasKey('queryParameters', EmptyStrategy1::$called);
+
+        $this->assertTrue(EmptyStrategy1::$called['responses']);
+    }
+
+    /** @test */
+    public function combines_responses_from_different_strategies()
+    {
+        $config = [
+            'strategies' => [
+                'responses' => [DummyResponseStrategy200::class, DummyResponseStrategy400::class],
+            ],
+        ];
+        $route = $this->createRoute('GET', '/api/test', 'dummy', true, TestController::class);
+        $generator = new Generator(new DocumentationConfig($config));
+        $parsed = $generator->processRoute($route);
+
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertCount(2, $parsed['responses']);
+        $first = array_shift($parsed['responses']);
+        $this->assertTrue(is_array($first));
+        $this->assertEquals(200, $first['status']);
+        $this->assertEquals('dummy', $first['content']);
+        $second = array_shift($parsed['responses']);
+        $this->assertTrue(is_array($second));
+        $this->assertEquals(400, $second['status']);
+        $this->assertEquals('dummy2', $second['content']);
+    }
+
+    // This is a generalized test, as opposed to the one above for responses only
+
+    /** @test */
+    public function combines_results_from_different_strategies_in_same_stage()
+    {
+        $config = [
+            'strategies' => [
+                'metadata' => [PartialDummyMetadataStrategy1::class, PartialDummyMetadataStrategy2::class],
+            ],
+        ];
+        $route = $this->createRoute('GET', '/api/test', 'dummy', true, TestController::class);
+        $generator = new Generator(new DocumentationConfig($config));
+        $parsed = $generator->processRoute($route);
+
+        $expectedMetadata = [
+            'groupName' => 'dummy',
+            'groupDescription' => 'dummy',
+            'title' => 'dummy',
+            'description' => 'dummy',
+            'authenticated' => false,
+        ];
+        $this->assertArraySubset($expectedMetadata, $parsed['metadata']);
+    }
+
+    /** @test */
+    public function missing_metadata_is_filled_in()
+    {
+        $config = [
+            'strategies' => [
+                'metadata' => [PartialDummyMetadataStrategy2::class],
+            ],
+        ];
+        $route = $this->createRoute('GET', '/api/test', 'dummy', true, TestController::class);
+        $generator = new Generator(new DocumentationConfig($config));
+        $parsed = $generator->processRoute($route);
+
+        $expectedMetadata = [
+            'groupName' => '',
+            'groupDescription' => 'dummy',
+            'title' => '',
+            'description' => 'dummy',
+            'authenticated' => false,
+        ];
+        $this->assertArraySubset($expectedMetadata, $parsed['metadata']);
+    }
+
+    /** @test */
+    public function overwrites_metadat_from_previous_strategies_in_same_stage()
+    {
+        $config = [
+            'strategies' => [
+                'metadata' => [NotDummyMetadataStrategy::class, PartialDummyMetadataStrategy1::class],
+            ],
+        ];
+        $route = $this->createRoute('GET', '/api/test', 'dummy', true, TestController::class);
+        $generator = new Generator(new DocumentationConfig($config));
+        $parsed = $generator->processRoute($route);
+
+        $expectedMetadata = [
+            'groupName' => 'dummy',
+            'groupDescription' => 'notdummy',
+            'title' => 'dummy',
+            'description' => 'dummy',
+            'authenticated' => false,
+        ];
+        $this->assertArraySubset($expectedMetadata, $parsed['metadata']);
+    }
+
+    public function dataResources()
+    {
+        return [
+            [
+                null,
+                '{"data":{"id":1,"description":"Welcome on this test versions","name":"TestName"}}',
+            ],
+            [
+                'League\Fractal\Serializer\JsonApiSerializer',
+                '{"data":{"type":null,"id":"1","attributes":{"description":"Welcome on this test versions","name":"TestName"}}}',
+            ],
+        ];
+    }
+}
+
+class EmptyStrategy1 extends Strategy
+{
+    public static $called = [];
+
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        static::$called[$this->stage] = true;
+    }
+}
+
+class EmptyStrategy2 extends Strategy
+{
+    public static $called = [];
+
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        static::$called[$this->stage] = true;
+    }
+}
+
+class NotDummyMetadataStrategy extends Strategy
+{
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        return [
+            'groupName' => 'notdummy',
+            'groupDescription' => 'notdummy',
+            'title' => 'notdummy',
+            'description' => 'notdummy',
+            'authenticated' => true,
+        ];
+    }
+}
+
+class PartialDummyMetadataStrategy1 extends Strategy
+{
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        return [
+            'groupName' => 'dummy',
+            'title' => 'dummy',
+            'description' => 'dummy',
+            'authenticated' => false,
+        ];
+    }
+}
+
+class PartialDummyMetadataStrategy2 extends Strategy
+{
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        return [
+            'description' => 'dummy',
+            'groupDescription' => 'dummy',
+        ];
+    }
+}
+
+class DummyResponseStrategy200 extends Strategy
+{
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        return [['status' => 200, 'content' => 'dummy']];
+    }
+}
+
+class DummyResponseStrategy400 extends Strategy
+{
+    public function __invoke(Route $route, ReflectionClass $controller, ReflectionMethod $method, array $routeRules, array $context = [])
+    {
+        return [['status' => 400, 'content' => 'dummy2']];
+    }
+}
diff --git a/tests/Unit/GeneratorTestCase.php b/tests/Unit/GeneratorTestCase.php
new file mode 100644
index 00000000..f4a167d6
--- /dev/null
+++ b/tests/Unit/GeneratorTestCase.php
@@ -0,0 +1,1024 @@
+<?php
+
+/** @noinspection ALL */
+
+namespace Mpociot\ApiDoc\Tests\Unit;
+
+use DMS\PHPUnitExtensions\ArraySubset\ArraySubsetAsserts;
+use Illuminate\Support\Arr;
+use Mpociot\ApiDoc\ApiDocGeneratorServiceProvider;
+use Mpociot\ApiDoc\Extracting\Generator;
+use Mpociot\ApiDoc\Tests\Fixtures\TestController;
+use Mpociot\ApiDoc\Tests\Fixtures\TestUser;
+use Mpociot\ApiDoc\Tools\DocumentationConfig;
+use Orchestra\Testbench\TestCase;
+
+abstract class GeneratorTestCase extends TestCase
+{
+    use ArraySubsetAsserts;
+
+    /**
+     * @var \Mpociot\ApiDoc\Extracting\Generator
+     */
+    protected $generator;
+    private $config = [
+        'strategies' => [
+            'metadata' => [
+                \Mpociot\ApiDoc\Extracting\Strategies\Metadata\GetFromDocBlocks::class,
+            ],
+            'urlParameters' => [
+                \Mpociot\ApiDoc\Extracting\Strategies\UrlParameters\GetFromUrlParamTag::class,
+            ],
+            'queryParameters' => [
+                \Mpociot\ApiDoc\Extracting\Strategies\QueryParameters\GetFromQueryParamTag::class,
+            ],
+            'headers' => [
+                \Mpociot\ApiDoc\Extracting\Strategies\RequestHeaders\GetFromRouteRules::class,
+            ],
+            'bodyParameters' => [
+                \Mpociot\ApiDoc\Extracting\Strategies\BodyParameters\GetFromBodyParamTag::class,
+            ],
+            'responses' => [
+                \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseTransformerTags::class,
+                \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseResponseTag::class,
+                \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseResponseFileTag::class,
+                \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseApiResourceTags::class,
+                \Mpociot\ApiDoc\Extracting\Strategies\Responses\ResponseCalls::class,
+            ],
+        ],
+        'default_group' => 'general',
+    ];
+
+    public static $globalValue = null;
+
+    protected function getPackageProviders($app)
+    {
+        return [
+            ApiDocGeneratorServiceProvider::class,
+        ];
+    }
+
+    /**
+     * Setup the test environment.
+     */
+    public function setUp(): void
+    {
+        parent::setUp();
+
+        $factory = app(\Illuminate\Database\Eloquent\Factory::class);
+        $factory->define(TestUser::class, function () {
+            return [
+                'id' => 4,
+                'first_name' => 'Tested',
+                'last_name' => 'Again',
+                'email' => 'a@b.com',
+            ];
+        });
+        $this->generator = new Generator(new DocumentationConfig($this->config));
+    }
+
+    /** @test */
+    public function can_parse_endpoint_description()
+    {
+        $route = $this->createRoute('GET', '/api/test', 'withEndpointDescription');
+        $parsed = $this->generator->processRoute($route);
+
+        $this->assertSame('Example title.', $parsed['metadata']['title']);
+        $this->assertSame("This will be the long description.\nIt can also be multiple lines long.", $parsed['metadata']['description']);
+    }
+
+    /** @test */
+    public function can_parse_body_parameters()
+    {
+        $route = $this->createRoute('GET', '/api/test', 'withBodyParameters');
+        $bodyParameters = $this->generator->processRoute($route)['bodyParameters'];
+
+        $this->assertArraySubset([
+            'user_id' => [
+                'type' => 'integer',
+                'required' => true,
+                'description' => 'The id of the user.',
+                'value' => 9,
+            ],
+            'room_id' => [
+                'type' => 'string',
+                'required' => false,
+                'description' => 'The id of the room.',
+            ],
+            'forever' => [
+                'type' => 'boolean',
+                'required' => false,
+                'description' => 'Whether to ban the user forever.',
+                'value' => false,
+            ],
+            'another_one' => [
+                'type' => 'number',
+                'required' => false,
+                'description' => 'Just need something here.',
+            ],
+            'yet_another_param' => [
+                'type' => 'object',
+                'required' => true,
+                'description' => 'Some object params.',
+            ],
+            'yet_another_param.name' => [
+                'type' => 'string',
+                'description' => 'Subkey in the object param.',
+                'required' => true,
+            ],
+            'even_more_param' => [
+                'type' => 'array',
+                'required' => false,
+                'description' => 'Some array params.',
+            ],
+            'even_more_param.*' => [
+                'type' => 'float',
+                'description' => 'Subkey in the array param.',
+                'required' => false,
+            ],
+            'book.name' => [
+                'type' => 'string',
+                'description' => '',
+                'required' => false,
+            ],
+            'book.author_id' => [
+                'type' => 'integer',
+                'description' => '',
+                'required' => false,
+            ],
+            'book[pages_count]' => [
+                'type' => 'integer',
+                'description' => '',
+                'required' => false,
+            ],
+            'ids.*' => [
+                'type' => 'integer',
+                'description' => '',
+                'required' => false,
+            ],
+            'users.*.first_name' => [
+                'type' => 'string',
+                'description' => 'The first name of the user.',
+                'required' => false,
+                'value' => 'John',
+            ],
+            'users.*.last_name' => [
+                'type' => 'string',
+                'description' => 'The last name of the user.',
+                'required' => false,
+                'value' => 'Doe',
+            ],
+        ], $bodyParameters);
+    }
+
+    /** @test */
+    public function can_parse_body_parameters_as_array()
+    {
+        $route = $this->createRoute('GET', '/api/test', 'withBodyParametersAsArray');
+        $generator = $this->generator->processRoute($route);
+        $bodyParameters = $generator['bodyParameters'];
+        $cleanBodyParameters = $generator['cleanBodyParameters'];
+
+        $this->assertArraySubset([
+            '*.first_name' => [
+                'type' => 'string',
+                'description' => 'The first name of the user.',
+                'required' => false,
+                'value' => 'John',
+            ],
+            '*.last_name' => [
+                'type' => 'string',
+                'description' => 'The last name of the user.',
+                'required' => false,
+                'value' => 'Doe',
+            ],
+            '*.contacts.*.first_name' => [
+                'type' => 'string',
+                'description' => 'The first name of the contact.',
+                'required' => false,
+                'value' => 'John',
+            ],
+            '*.contacts.*.last_name' => [
+                'type' => 'string',
+                'description' => 'The last name of the contact.',
+                'required' => false,
+                'value' => 'Doe',
+            ],
+            '*.roles.*' => [
+                'type' => 'string',
+                'description' => 'The name of the role.',
+                'required' => false,
+                'value' => 'Admin',
+            ],
+        ], $bodyParameters);
+
+        $this->assertArraySubset([
+            [
+               'first_name' => 'John',
+               'last_name' => 'Doe',
+               'contacts' => [
+                    [
+                        'first_name' => 'John',
+                        'last_name' => 'Doe',
+                    ]
+                ],
+                'roles' => [
+                    'Admin'
+                ]
+            ]
+        ], $cleanBodyParameters);
+    }
+
+    /** @test */
+    public function it_ignores_non_commented_form_request()
+    {
+        $route = $this->createRoute('GET', '/api/test', 'withNonCommentedFormRequestParameter');
+        $bodyParameters = $this->generator->processRoute($route)['bodyParameters'];
+
+        $this->assertArraySubset([
+            'direct_one' => [
+                'type' => 'string',
+                'description' => 'Is found directly on the method.',
+            ],
+        ], $bodyParameters);
+    }
+
+    /** @test */
+    public function can_parse_form_request_body_parameters()
+    {
+        $route = $this->createRoute('GET', '/api/test', 'withFormRequestParameter');
+        $bodyParameters = $this->generator->processRoute($route)['bodyParameters'];
+
+        $this->assertArraySubset([
+            'user_id' => [
+                'type' => 'integer',
+                'required' => true,
+                'description' => 'The id of the user.',
+                'value' => 9,
+            ],
+            'room_id' => [
+                'type' => 'string',
+                'required' => false,
+                'description' => 'The id of the room.',
+            ],
+            'forever' => [
+                'type' => 'boolean',
+                'required' => false,
+                'description' => 'Whether to ban the user forever.',
+                'value' => false,
+            ],
+            'another_one' => [
+                'type' => 'number',
+                'required' => false,
+                'description' => 'Just need something here.',
+            ],
+            'yet_another_param' => [
+                'type' => 'object',
+                'required' => true,
+                'description' => '',
+            ],
+            'even_more_param' => [
+                'type' => 'array',
+                'required' => false,
+                'description' => '',
+            ],
+        ], $bodyParameters);
+    }
+
+    /** @test */
+    public function can_parse_multiple_form_request_body_parameters()
+    {
+        $route = $this->createRoute('GET', '/api/test', 'withMultipleFormRequestParameters');
+        $bodyParameters = $this->generator->processRoute($route)['bodyParameters'];
+
+        $this->assertArraySubset([
+            'user_id' => [
+                'type' => 'integer',
+                'required' => true,
+                'description' => 'The id of the user.',
+                'value' => 9,
+            ],
+            'room_id' => [
+                'type' => 'string',
+                'required' => false,
+                'description' => 'The id of the room.',
+            ],
+            'forever' => [
+                'type' => 'boolean',
+                'required' => false,
+                'description' => 'Whether to ban the user forever.',
+                'value' => false,
+            ],
+            'another_one' => [
+                'type' => 'number',
+                'required' => false,
+                'description' => 'Just need something here.',
+            ],
+            'yet_another_param' => [
+                'type' => 'object',
+                'required' => true,
+                'description' => '',
+            ],
+            'even_more_param' => [
+                'type' => 'array',
+                'required' => false,
+                'description' => '',
+            ],
+        ], $bodyParameters);
+    }
+
+    /** @test */
+    public function can_parse_query_parameters()
+    {
+        $route = $this->createRoute('GET', '/api/test', 'withQueryParameters');
+        $queryParameters = $this->generator->processRoute($route)['queryParameters'];
+
+        $this->assertArraySubset([
+            'location_id' => [
+                'required' => true,
+                'description' => 'The id of the location.',
+            ],
+            'user_id' => [
+                'required' => true,
+                'description' => 'The id of the user.',
+                'value' => 'me',
+            ],
+            'page' => [
+                'required' => true,
+                'description' => 'The page number.',
+                'value' => '4',
+            ],
+            'filters' => [
+                'required' => false,
+                'description' => 'The filters.',
+            ],
+        ], $queryParameters);
+    }
+
+    /** @test */
+    public function it_does_not_generate_values_for_excluded_params_and_excludes_them_from_clean_params()
+    {
+        $route = $this->createRoute('GET', '/api/test', 'withExcludedExamples');
+        $parsed = $this->generator->processRoute($route);
+        $cleanBodyParameters = $parsed['cleanBodyParameters'];
+        $cleanQueryParameters = $parsed['cleanQueryParameters'];
+        $bodyParameters = $parsed['bodyParameters'];
+        $queryParameters = $parsed['queryParameters'];
+
+        $this->assertArrayHasKey('included', $cleanBodyParameters);
+        $this->assertArrayNotHasKey('excluded_body_param', $cleanBodyParameters);
+        $this->assertEmpty($cleanQueryParameters);
+
+        $this->assertArraySubset([
+            'included' => [
+                'required' => true,
+                'type' => 'string',
+                'description' => 'Exists in examples.',
+            ],
+            'excluded_body_param' => [
+                'type' => 'integer',
+                'description' => 'Does not exist in examples.',
+            ],
+        ], $bodyParameters);
+
+        $this->assertArraySubset([
+            'excluded_query_param' => [
+                'description' => 'Does not exist in examples.',
+            ],
+        ], $queryParameters);
+    }
+
+    /** @test */
+    public function can_parse_route_group()
+    {
+        $route = $this->createRoute('GET', '/api/test', 'dummy');
+        $routeGroup = $this->generator->processRoute($route)['metadata']['groupName'];
+
+        $this->assertSame('Group A', $routeGroup);
+    }
+
+    /** @test */
+    public function method_can_override_controller_group()
+    {
+        $route = $this->createRoute('GET', '/group/1', 'withGroupOverride');
+        $parsedRoute = $this->generator->processRoute($route);
+        $this->assertSame('Group B', $parsedRoute['metadata']['groupName']);
+        $this->assertSame('', $parsedRoute['metadata']['groupDescription']);
+
+        $route = $this->createRoute('GET', '/group/2', 'withGroupOverride2');
+        $parsedRoute = $this->generator->processRoute($route);
+        $this->assertSame('Group B', $parsedRoute['metadata']['groupName']);
+        $this->assertSame('', $parsedRoute['metadata']['groupDescription']);
+        $this->assertSame('This is also in Group B. No route description. Route title before gropp.', $parsedRoute['metadata']['title']);
+
+        $route = $this->createRoute('GET', '/group/3', 'withGroupOverride3');
+        $parsedRoute = $this->generator->processRoute($route);
+        $this->assertSame('Group B', $parsedRoute['metadata']['groupName']);
+        $this->assertSame('', $parsedRoute['metadata']['groupDescription']);
+        $this->assertSame('This is also in Group B. Route title after group.', $parsedRoute['metadata']['title']);
+
+        $route = $this->createRoute('GET', '/group/4', 'withGroupOverride4');
+        $parsedRoute = $this->generator->processRoute($route);
+        $this->assertSame('Group C', $parsedRoute['metadata']['groupName']);
+        $this->assertSame('Group description after group.', $parsedRoute['metadata']['groupDescription']);
+        $this->assertSame('This is in Group C. Route title before group.', $parsedRoute['metadata']['title']);
+    }
+
+    /** @test */
+    public function can_parse_auth_tags()
+    {
+        $route = $this->createRoute('GET', '/api/test', 'withAuthenticatedTag');
+        $authenticated = $this->generator->processRoute($route)['metadata']['authenticated'];
+        $this->assertTrue($authenticated);
+
+        $route = $this->createRoute('GET', '/api/test', 'dummy');
+        $authenticated = $this->generator->processRoute($route)['metadata']['authenticated'];
+        $this->assertFalse($authenticated);
+    }
+
+    /** @test */
+    public function can_parse_route_methods()
+    {
+        $route = $this->createRoute('GET', '/get', 'withEndpointDescription');
+        $parsed = $this->generator->processRoute($route);
+        $this->assertSame(['GET'], $parsed['methods']);
+
+        $route = $this->createRoute('POST', '/post', 'withEndpointDescription');
+        $parsed = $this->generator->processRoute($route);
+        $this->assertSame(['POST'], $parsed['methods']);
+
+        $route = $this->createRoute('PUT', '/put', 'withEndpointDescription');
+        $parsed = $this->generator->processRoute($route);
+        $this->assertSame(['PUT'], $parsed['methods']);
+
+        $route = $this->createRoute('DELETE', '/delete', 'withEndpointDescription');
+        $parsed = $this->generator->processRoute($route);
+        $this->assertSame(['DELETE'], $parsed['methods']);
+    }
+
+    /** @test */
+    public function can_parse_apiresource_tags()
+    {
+        $route = $this->createRoute('POST', '/withEloquentApiResource', 'withEloquentApiResource');
+
+        $config = $this->config;
+        $config['strategies']['responses'] = [\Mpociot\ApiDoc\Extracting\Strategies\Responses\UseApiResourceTags::class];
+        $generator = new Generator(new DocumentationConfig($config));
+        $parsed = $this->generator->processRoute($route);
+
+        $response = Arr::first($parsed['responses']);
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $this->assertArraySubset([
+            'data' => [
+                'id' => 4,
+                'name' => 'Tested Again',
+                'email' => 'a@b.com',
+            ],
+        ], json_decode($response['content'], true));
+    }
+
+    /** @test */
+    public function can_parse_apiresourcecollection_tags()
+    {
+        $route = $this->createRoute('POST', '/withEloquentApiResourceCollection', 'withEloquentApiResourceCollection');
+
+        $config = $this->config;
+        $config['strategies']['responses'] = [\Mpociot\ApiDoc\Extracting\Strategies\Responses\UseApiResourceTags::class];
+        $generator = new Generator(new DocumentationConfig($config));
+        $parsed = $this->generator->processRoute($route);
+
+        $response = Arr::first($parsed['responses']);
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $content = json_decode($response['content'], true);
+        $this->assertIsArray($content);
+        $this->assertArraySubset([
+            'id' => 4,
+            'name' => 'Tested Again',
+            'email' => 'a@b.com',
+        ], $content['data'][0]);
+        $this->assertArraySubset([
+            'id' => 4,
+            'name' => 'Tested Again',
+            'email' => 'a@b.com',
+        ], $content['data'][1]);
+    }
+
+    /** @test */
+    public function can_parse_apiresourcecollection_tags_with_collection_class()
+    {
+        $route = $this->createRoute('POST', '/withEloquentApiResourceCollectionClass', 'withEloquentApiResourceCollectionClass');
+
+        $config = $this->config;
+        $config['strategies']['responses'] = [\Mpociot\ApiDoc\Extracting\Strategies\Responses\UseApiResourceTags::class];
+        $generator = new Generator(new DocumentationConfig($config));
+        $parsed = $this->generator->processRoute($route);
+
+        $response = Arr::first($parsed['responses']);
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $content = json_decode($response['content'], true);
+        $this->assertIsArray($content);
+        $this->assertArraySubset([
+            'data' => [
+                [
+                    'id' => 4,
+                    'name' => 'Tested Again',
+                    'email' => 'a@b.com',
+                ],
+                [
+                    'id' => 4,
+                    'name' => 'Tested Again',
+                    'email' => 'a@b.com',
+                ],
+            ],
+            'links' => [
+                'self' => 'link-value',
+            ],
+        ], $content);
+    }
+
+    /** @test */
+    public function can_parse_response_tag()
+    {
+        $route = $this->createRoute('POST', '/responseTag', 'withResponseTag');
+        $parsed = $this->generator->processRoute($route);
+        $response = Arr::first($parsed['responses']);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $this->assertArraySubset([
+            'id' => 4,
+            'name' => 'banana',
+            'color' => 'red',
+            'weight' => '1 kg',
+            'delicious' => true,
+        ], json_decode($response['content'], true));
+    }
+
+    /** @test */
+    public function can_parse_response_tag_with_status_code()
+    {
+        $route = $this->createRoute('POST', '/responseTag', 'withResponseTagAndStatusCode');
+        $parsed = $this->generator->processRoute($route);
+        $response = Arr::first($parsed['responses']);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(422, $response['status']);
+        $this->assertArraySubset([
+            'message' => 'Validation error',
+        ], json_decode($response['content'], true));
+    }
+
+    /** @test */
+    public function can_parse_multiple_response_tags()
+    {
+        $route = $this->createRoute('POST', '/responseTag', 'withMultipleResponseTagsAndStatusCode');
+        $parsed = $this->generator->processRoute($route);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($parsed['responses'][0]));
+        $this->assertEquals(200, $parsed['responses'][0]['status']);
+        $this->assertArraySubset([
+            'id' => 4,
+            'name' => 'banana',
+            'color' => 'red',
+            'weight' => '1 kg',
+            'delicious' => true,
+        ], json_decode($parsed['responses'][0]['content'], true));
+        $this->assertTrue(is_array($parsed['responses'][1]));
+        $this->assertEquals(401, $parsed['responses'][1]['status']);
+        $this->assertArraySubset([
+            'message' => 'Unauthorized',
+        ], json_decode($parsed['responses'][1]['content'], true));
+    }
+
+    /**
+     * @param $serializer
+     * @param $expected
+     *
+     * @test
+     * @dataProvider dataResources
+     */
+    public function can_parse_transformer_tag($serializer, $expected)
+    {
+        config(['apidoc.fractal.serializer' => $serializer]);
+        $route = $this->createRoute('GET', '/transformerTag', 'transformerTag');
+        $parsed = $this->generator->processRoute($route);
+        $response = Arr::first($parsed['responses']);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $this->assertSame(
+            $expected,
+            $response['content']
+        );
+    }
+
+    /** @test */
+    public function can_parse_transformer_tag_with_model()
+    {
+        $route = $this->createRoute('GET', '/transformerTagWithModel', 'transformerTagWithModel');
+        $parsed = $this->generator->processRoute($route);
+        $response = Arr::first($parsed['responses']);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $this->assertSame(
+            '{"data":{"id":1,"description":"Welcome on this test versions","name":"TestName"}}',
+            $response['content']
+        );
+    }
+
+    /** @test */
+    public function can_parse_transformer_tag_with_status_code()
+    {
+        $route = $this->createRoute('GET', '/transformerTagWithStatusCode', 'transformerTagWithStatusCode');
+        $parsed = $this->generator->processRoute($route);
+        $response = Arr::first($parsed['responses']);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(201, $response['status']);
+        $this->assertSame(
+            '{"data":{"id":1,"description":"Welcome on this test versions","name":"TestName"}}',
+            $response['content']
+        );
+    }
+
+    /** @test */
+    public function can_parse_transformer_collection_tag()
+    {
+        $route = $this->createRoute('GET', '/transformerCollectionTag', 'transformerCollectionTag');
+        $parsed = $this->generator->processRoute($route);
+        $response = Arr::first($parsed['responses']);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $this->assertSame(
+            $response['content'],
+            '{"data":[{"id":1,"description":"Welcome on this test versions","name":"TestName"},' .
+            '{"id":1,"description":"Welcome on this test versions","name":"TestName"}]}'
+        );
+    }
+
+    /** @test */
+    public function can_parse_transformer_collection_tag_with_model()
+    {
+        $route = $this->createRoute('GET', '/transformerCollectionTagWithModel', 'transformerCollectionTagWithModel');
+        $parsed = $this->generator->processRoute($route);
+        $response = Arr::first($parsed['responses']);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $this->assertSame(
+            $response['content'],
+            '{"data":[{"id":1,"description":"Welcome on this test versions","name":"TestName"},' .
+            '{"id":1,"description":"Welcome on this test versions","name":"TestName"}]}'
+        );
+    }
+
+    /** @test */
+    public function can_call_route_and_generate_response()
+    {
+        $route = $this->createRoute('POST', '/shouldFetchRouteResponse', 'shouldFetchRouteResponse', true);
+
+        $rules = [
+            'headers' => [
+                'Content-Type' => 'application/json',
+                'Accept' => 'application/json',
+            ],
+            'response_calls' => [
+                'methods' => ['*'],
+            ],
+        ];
+        $parsed = $this->generator->processRoute($route, $rules);
+        $response = Arr::first($parsed['responses']);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $this->assertArraySubset([
+            'id' => 4,
+            'name' => 'banana',
+            'color' => 'red',
+            'weight' => '1 kg',
+            'delicious' => true,
+        ], json_decode($response['content'], true));
+    }
+
+    /** @test */
+    public function does_not_make_response_call_if_success_response_already_gotten()
+    {
+        $route = $this->createRoute('POST', '/withResponseTag', 'withResponseTag', true);
+
+        $rules = [
+            'headers' => [
+                'Content-Type' => 'application/json',
+                'Accept' => 'application/json',
+            ],
+            'response_calls' => [
+                'methods' => ['*'],
+            ],
+        ];
+        $config = [
+            'strategies' => [
+                'responses' => [
+                    \Mpociot\ApiDoc\Extracting\Strategies\Responses\UseResponseTag::class,
+                    \Mpociot\ApiDoc\Extracting\Strategies\Responses\ResponseCalls::class,
+                ],
+            ],
+        ];
+        $generator = new Generator(new DocumentationConfig($config));
+        $parsed = $generator->processRoute($route, $rules);
+
+        $this->assertCount(1, $parsed['responses']);
+        $response = Arr::first($parsed['responses']);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $this->assertArraySubset([
+            'id' => 4,
+            'name' => 'banana',
+            'color' => 'red',
+            'weight' => '1 kg',
+            'delicious' => true,
+            'responseTag' => true,
+        ], json_decode($response['content'], true));
+
+        // This may probably not be the best way to test this, but 🤷‍♀️
+        $this->assertNull(static::$globalValue);
+    }
+
+    /** @test */
+    public function can_override_config_during_response_call()
+    {
+        $route = $this->createRoute('POST', '/echoesConfig', 'echoesConfig', true);
+
+        $rules = [
+            'response_calls' => [
+                'methods' => ['*'],
+            ],
+        ];
+        $parsed = $this->generator->processRoute($route, $rules);
+        $response = json_decode(Arr::first($parsed['responses'])['content'], true);
+        $originalValue = $response['app.env'];
+
+        $now = time();
+        $rules = [
+            'response_calls' => [
+                'methods' => ['*'],
+                'config' => [
+                    'app.env' => $now,
+                ],
+            ],
+        ];
+        $parsed = $this->generator->processRoute($route, $rules);
+        $response = json_decode(Arr::first($parsed['responses'])['content'], true);
+        $newValue = $response['app.env'];
+        $this->assertEquals($now, $newValue);
+        $this->assertNotEquals($originalValue, $newValue);
+    }
+
+    /** @test */
+    public function can_override_url_path_parameters_with_urlparam_annotation()
+    {
+        $route = $this->createRoute('POST', '/echoesUrlParameters/{param}', 'echoesUrlParameters', true);
+        $rules = [
+            'response_calls' => [
+                'methods' => ['*'],
+            ],
+        ];
+        $parsed = $this->generator->processRoute($route, $rules);
+        $response = json_decode(Arr::first($parsed['responses'])['content'], true);
+        $this->assertEquals(4, $response['param']);
+    }
+
+    /** @test */
+    public function ignores_or_inserts_optional_url_path_parameters_according_to_annotations()
+    {
+        $route = $this->createRoute('POST', '/echoesUrlParameters/{param}/{param2?}/{param3}/{param4?}', 'echoesUrlParameters', true);
+
+        $rules = [
+            'response_calls' => [
+                'methods' => ['*'],
+            ],
+        ];
+        $parsed = $this->generator->processRoute($route, $rules);
+        $response = json_decode(Arr::first($parsed['responses'])['content'], true);
+        $this->assertEquals(4, $response['param']);
+        $this->assertNotNull($response['param2']);
+        $this->assertEquals(1, $response['param3']);
+        $this->assertNull($response['param4']);
+    }
+
+    /** @test */
+    public function can_parse_response_file_tag()
+    {
+        // copy file to storage
+        $filePath = __DIR__ . '/../Fixtures/response_test.json';
+        $fixtureFileJson = file_get_contents($filePath);
+        copy($filePath, storage_path('response_test.json'));
+
+        $route = $this->createRoute('GET', '/responseFileTag', 'responseFileTag');
+        $parsed = $this->generator->processRoute($route);
+        $response = Arr::first($parsed['responses']);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $this->assertSame(
+            $response['content'],
+            $fixtureFileJson
+        );
+
+        unlink(storage_path('response_test.json'));
+    }
+
+    /** @test */
+    public function can_add_or_replace_key_value_pair_in_response_file()
+    {
+        // copy file to storage
+        $filePath = __DIR__ . '/../Fixtures/response_test.json';
+        $fixtureFileJson = file_get_contents($filePath);
+        copy($filePath, storage_path('response_test.json'));
+
+        $route = $this->createRoute('GET', '/responseFileTagAndCustomJson', 'responseFileTagAndCustomJson');
+        $parsed = $this->generator->processRoute($route);
+        $response = Arr::first($parsed['responses']);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $this->assertNotSame(
+            $response['content'],
+            $fixtureFileJson
+        );
+
+        unlink(storage_path('response_test.json'));
+    }
+
+    /** @test */
+    public function can_parse_multiple_response_file_tags_with_status_codes()
+    {
+        // copy file to storage
+        $successFilePath = __DIR__ . '/../Fixtures/response_test.json';
+        $successFixtureFileJson = file_get_contents($successFilePath);
+        copy($successFilePath, storage_path('response_test.json'));
+        $errorFilePath = __DIR__ . '/../Fixtures/response_error_test.json';
+        $errorFixtureFileJson = file_get_contents($errorFilePath);
+        copy($errorFilePath, storage_path('response_error_test.json'));
+
+        $route = $this->createRoute('GET', '/responseFileTag', 'withResponseFileTagAndStatusCode');
+        $parsed = $this->generator->processRoute($route);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($parsed['responses'][0]));
+        $this->assertEquals(200, $parsed['responses'][0]['status']);
+        $this->assertSame(
+            $parsed['responses'][0]['content'],
+            $successFixtureFileJson
+        );
+        $this->assertTrue(is_array($parsed['responses'][1]));
+        $this->assertEquals(401, $parsed['responses'][1]['status']);
+        $this->assertSame(
+            $parsed['responses'][1]['content'],
+            $errorFixtureFileJson
+        );
+
+        unlink(storage_path('response_test.json'));
+        unlink(storage_path('response_error_test.json'));
+    }
+
+    /** @test */
+    public function generates_consistent_examples_when_faker_seed_is_set()
+    {
+        $route = $this->createRoute('GET', '/withBodyParameters', 'withBodyParameters');
+
+        $paramName = 'room_id';
+        $results = [];
+        $results[$this->generator->processRoute($route)['cleanBodyParameters'][$paramName]] = true;
+        $results[$this->generator->processRoute($route)['cleanBodyParameters'][$paramName]] = true;
+        $results[$this->generator->processRoute($route)['cleanBodyParameters'][$paramName]] = true;
+        $results[$this->generator->processRoute($route)['cleanBodyParameters'][$paramName]] = true;
+        $results[$this->generator->processRoute($route)['cleanBodyParameters'][$paramName]] = true;
+        // Examples should have different values
+        $this->assertNotEquals(count($results), 1);
+
+        $generator = new Generator(new DocumentationConfig($this->config + ['faker_seed' => 12345]));
+        $results = [];
+        $results[$generator->processRoute($route)['cleanBodyParameters'][$paramName]] = true;
+        $results[$generator->processRoute($route)['cleanBodyParameters'][$paramName]] = true;
+        $results[$generator->processRoute($route)['cleanBodyParameters'][$paramName]] = true;
+        $results[$generator->processRoute($route)['cleanBodyParameters'][$paramName]] = true;
+        // Examples should have same values
+        $this->assertEquals(count($results), 1);
+    }
+
+    /** @test */
+    public function uses_configured_settings_when_calling_route()
+    {
+        $route = $this->createRoute('PUT', '/echo/{id}', 'shouldFetchRouteResponseWithEchoedSettings', true);
+
+        $rules = [
+            'headers' => [
+                'Content-Type' => 'application/json',
+                'Accept' => 'application/json',
+                'header' => 'value',
+            ],
+            'response_calls' => [
+                'methods' => ['*'],
+                'queryParams' => [
+                    'queryParam' => 'queryValue',
+                ],
+                'bodyParams' => [
+                    'bodyParam' => 'bodyValue',
+                ],
+            ],
+        ];
+        $parsed = $this->generator->processRoute($route, $rules);
+        $response = Arr::first($parsed['responses']);
+
+        $this->assertTrue(is_array($parsed));
+        $this->assertArrayHasKey('showresponse', $parsed);
+        $this->assertTrue($parsed['showresponse']);
+        $this->assertTrue(is_array($response));
+        $this->assertEquals(200, $response['status']);
+        $responseContent = json_decode($response['content'], true);
+        $this->assertEquals('queryValue', $responseContent['queryParam']);
+        $this->assertEquals('bodyValue', $responseContent['bodyParam']);
+        $this->assertEquals('value', $responseContent['header']);
+    }
+
+    /** @test */
+    public function can_use_arrays_in_routes_uses()
+    {
+        $route = $this->createRouteUsesArray('GET', '/api/array/test', 'withEndpointDescription');
+
+        $parsed = $this->generator->processRoute($route);
+
+        $this->assertSame('Example title.', $parsed['metadata']['title']);
+        $this->assertSame("This will be the long description.\nIt can also be multiple lines long.", $parsed['metadata']['description']);
+    }
+
+    abstract public function createRoute(string $httpMethod, string $path, string $controllerMethod, $register = false, $class = TestController::class);
+
+    abstract public function createRouteUsesArray(string $httpMethod, string $path, string $controllerMethod, $register = false, $class = TestController::class);
+
+    public function dataResources()
+    {
+        return [
+            [
+                null,
+                '{"data":{"id":1,"description":"Welcome on this test versions","name":"TestName"}}',
+            ],
+            [
+                'League\Fractal\Serializer\JsonApiSerializer',
+                '{"data":{"type":null,"id":"1","attributes":{"description":"Welcome on this test versions","name":"TestName"}}}',
+            ],
+        ];
+    }
+}
diff --git a/tests/Unit/LaravelGeneratorTest.php b/tests/Unit/LaravelGeneratorTest.php
new file mode 100644
index 00000000..e543036c
--- /dev/null
+++ b/tests/Unit/LaravelGeneratorTest.php
@@ -0,0 +1,36 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests\Unit;
+
+use Illuminate\Routing\Route;
+use Illuminate\Support\Facades\Route as RouteFacade;
+use Mpociot\ApiDoc\ApiDocGeneratorServiceProvider;
+use Mpociot\ApiDoc\Tests\Fixtures\TestController;
+
+class LaravelGeneratorTest extends GeneratorTestCase
+{
+    protected function getPackageProviders($app)
+    {
+        return [
+            ApiDocGeneratorServiceProvider::class,
+        ];
+    }
+
+    public function createRoute(string $httpMethod, string $path, string $controllerMethod, $register = false, $class = TestController::class)
+    {
+        if ($register) {
+            return RouteFacade::{$httpMethod}($path, $class . "@$controllerMethod");
+        } else {
+            return new Route([$httpMethod], $path, ['uses' => $class . "@$controllerMethod"]);
+        }
+    }
+
+    public function createRouteUsesArray(string $httpMethod, string $path, string $controllerMethod, $register = false, $class = TestController::class)
+    {
+        if ($register) {
+            return RouteFacade::{$httpMethod}($path, [$class . "$controllerMethod"]);
+        } else {
+            return new Route([$httpMethod], $path, ['uses' => [$class, $controllerMethod]]);
+        }
+    }
+}
diff --git a/tests/Unit/PostmanCollectionWriterTest.php b/tests/Unit/PostmanCollectionWriterTest.php
new file mode 100644
index 00000000..9462cec1
--- /dev/null
+++ b/tests/Unit/PostmanCollectionWriterTest.php
@@ -0,0 +1,313 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests\Unit;
+
+use Illuminate\Support\Collection;
+use Mpociot\ApiDoc\Writing\PostmanCollectionWriter;
+use Orchestra\Testbench\TestCase;
+
+class PostmanCollectionWriterTest extends TestCase
+{
+    public function testNameIsPresentInCollection()
+    {
+        \Config::set('apidoc.postman', [
+            'name' => 'Test collection',
+        ]);
+
+        $writer = new PostmanCollectionWriter(new Collection(), '');
+        $collection = $writer->getCollection();
+
+        $this->assertSame('Test collection', json_decode($collection)->info->name);
+    }
+
+    public function testFallbackCollectionNameIsUsed()
+    {
+        \Config::set('app.name', 'Fake App');
+
+        $writer = new PostmanCollectionWriter(new Collection(), '');
+        $collection = $writer->getCollection();
+
+        $this->assertSame('Fake App API', json_decode($collection)->info->name);
+    }
+
+    public function testDescriptionIsPresentInCollection()
+    {
+        \Config::set('apidoc.postman', [
+            'description' => 'A fake description',
+        ]);
+
+        $writer = new PostmanCollectionWriter(new Collection(), '');
+        $collection = $writer->getCollection();
+
+        $this->assertSame('A fake description', json_decode($collection)->info->description);
+    }
+
+    public function testAuthIsNotIncludedWhenNull()
+    {
+        $writer = new PostmanCollectionWriter(new Collection(), '');
+        $collection = $writer->getCollection();
+
+        $this->assertArrayNotHasKey('auth', json_decode($collection, true));
+    }
+
+    public function testAuthIsIncludedVerbatim()
+    {
+        $auth = [
+            'type' => 'test',
+            'test' => ['a' => 1],
+        ];
+        \Config::set('apidoc.postman', [
+            'auth' => $auth,
+        ]);
+
+        $writer = new PostmanCollectionWriter(new Collection(), '');
+        $collection = $writer->getCollection();
+
+        $this->assertSame($auth, json_decode($collection, true)['auth']);
+    }
+
+    public function testEndpointIsParsed()
+    {
+        $route = $this->createMockRouteData('some/path');
+
+        // Ensure method is set correctly for assertion later
+        $route['methods'] = ['GET'];
+
+        $collection = $this->createMockRouteGroup([$route], 'Group');
+
+        $writer = new PostmanCollectionWriter($collection, 'fake.localhost');
+        $collection = json_decode($writer->getCollection(), true);
+
+        $this->assertSame('Group', data_get($collection, 'item.0.name'), 'Group name exists');
+
+        $item = data_get($collection, 'item.0.item.0');
+        $this->assertSame('some/path', $item['name'], 'Name defaults to path');
+        $this->assertSame('http', data_get($item, 'request.url.protocol'), 'Protocol defaults to http');
+        $this->assertSame('fake.localhost', data_get($item, 'request.url.host'), 'Host uses what\'s given');
+        $this->assertSame('some/path', data_get($item, 'request.url.path'), 'Path is set correctly');
+        $this->assertEmpty(data_get($item, 'request.url.query'), 'Query parameters are empty');
+        $this->assertSame('GET', data_get($item, 'request.method'), 'Method is correctly resolved');
+        $this->assertContains([
+            'key' => 'Accept',
+            'value' => 'application/json',
+        ], data_get($item, 'request.header'), 'JSON Accept header is added');
+    }
+
+    public function testHttpsProtocolIsDetected()
+    {
+        $collection = $this->createMockRouteGroup([$this->createMockRouteData('fake')]);
+        $writer = new PostmanCollectionWriter($collection, 'https://fake.localhost/');
+        $collection = json_decode($writer->getCollection(), true);
+
+        $this->assertSame('https', data_get($collection, 'item.0.item.0.request.url.protocol'));
+    }
+
+    public function testHeadersArePulledFromRoute()
+    {
+        $route = $this->createMockRouteData('some/path');
+
+        $route['headers'] = ['X-Fake' => 'Test'];
+
+        $collection = $this->createMockRouteGroup([$route], 'Group');
+        $writer = new PostmanCollectionWriter($collection, 'fake.localhost');
+        $collection = json_decode($writer->getCollection(), true);
+
+        $this->assertContains([
+            'key' => 'X-Fake',
+            'value' => 'Test',
+        ], data_get($collection, 'item.0.item.0.request.header'));
+    }
+
+    public function testUrlParametersAreConverted()
+    {
+        $collection = $this->createMockRouteGroup([$this->createMockRouteData('fake/{param}')]);
+        $writer = new PostmanCollectionWriter($collection, 'fake.localhost');
+        $collection = json_decode($writer->getCollection(), true);
+
+        $item = data_get($collection, 'item.0.item.0');
+        $this->assertSame('fake/{param}', $item['name'], 'Name defaults to path');
+        $this->assertSame('fake/:param', data_get($item, 'request.url.path'), 'Path is converted');
+    }
+
+    public function testUrlParamsResolveTheirDocumentation()
+    {
+        $fakeRoute = $this->createMockRouteData('fake/{param}');
+
+        $fakeRoute['urlParameters'] = ['param' => [
+            'description' => 'A test description for the test param',
+            'required' => true,
+            'value' => 'foobar',
+        ]];
+
+        $collection = $this->createMockRouteGroup([$fakeRoute]);
+        $writer = new PostmanCollectionWriter($collection, 'fake.localhost');
+        $collection = json_decode($writer->getCollection(), true);
+
+        $variableData = data_get($collection, 'item.0.item.0.request.url.variable');
+
+        $this->assertCount(1, $variableData);
+        $this->assertSame([
+            'id' => 'param',
+            'key' => 'param',
+            'value' => 'foobar',
+            'description' => 'A test description for the test param',
+        ], $variableData[0]);
+    }
+
+    public function testQueryParametersAreDocumented()
+    {
+        $fakeRoute = $this->createMockRouteData('fake/path');
+
+        $fakeRoute['queryParameters'] = ['limit' => [
+            'description' => 'A fake limit for my fake endpoint',
+            'required' => false,
+            'value' => 5,
+        ]];
+
+        $collection = $this->createMockRouteGroup([$fakeRoute]);
+        $writer = new PostmanCollectionWriter($collection, 'fake.localhost');
+        $collection = json_decode($writer->getCollection(), true);
+
+        $variableData = data_get($collection, 'item.0.item.0.request.url.query');
+
+        $this->assertCount(1, $variableData);
+        $this->assertSame([
+            'key' => 'limit',
+            'value' => '5',
+            'description' => 'A fake limit for my fake endpoint',
+            'disabled' => false,
+        ], $variableData[0]);
+    }
+
+    public function testUrlParametersAreNotIncludedIfMissingFromPath()
+    {
+        $fakeRoute = $this->createMockRouteData('fake/path');
+
+        $fakeRoute['urlParameters'] = ['limit' => [
+            'description' => 'A fake limit for my fake endpoint',
+            'required' => false,
+            'value' => 5,
+        ]];
+
+        $collection = $this->createMockRouteGroup([$fakeRoute]);
+        $writer = new PostmanCollectionWriter($collection, 'fake.localhost');
+        $collection = json_decode($writer->getCollection(), true);
+
+        $variableData = data_get($collection, 'item.0.item.0.request.url.query');
+
+        $this->assertCount(0, $variableData);
+    }
+
+    public function testQueryParametersAreDisabledWithNoValueWhenNotRequired()
+    {
+        $fakeRoute = $this->createMockRouteData('fake/path');
+        $fakeRoute['queryParameters'] = [
+            'required' => [
+                'description' => 'A required param with a null value',
+                'required' => true,
+                'value' => null,
+            ],
+            'not_required' => [
+                'description' => 'A not required param with a null value',
+                'required' => false,
+                'value' => null,
+            ],
+        ];
+
+        $collection = $this->createMockRouteGroup([$fakeRoute]);
+        $writer = new PostmanCollectionWriter($collection, 'fake.localhost');
+        $collection = json_decode($writer->getCollection(), true);
+
+        $variableData = data_get($collection, 'item.0.item.0.request.url.query');
+
+        $this->assertCount(2, $variableData);
+        $this->assertContains([
+            'key' => 'required',
+            'value' => null,
+            'description' => 'A required param with a null value',
+            'disabled' => false,
+        ], $variableData);
+        $this->assertContains([
+            'key' => 'not_required',
+            'value' => null,
+            'description' => 'A not required param with a null value',
+            'disabled' => true,
+        ], $variableData);
+    }
+
+    /**
+     * @dataProvider provideAuthConfigHeaderData
+     */
+    public function testAuthAutoExcludesHeaderDefinitions(array $authConfig, array $expectedRemovedHeaders)
+    {
+        \Config::set('apidoc.postman', [
+            'auth' => $authConfig,
+        ]);
+
+        $route = $this->createMockRouteData('some/path');
+        $route['headers'] = $expectedRemovedHeaders;
+        $collection = $this->createMockRouteGroup([$route], 'Group');
+        $writer = new PostmanCollectionWriter($collection, 'fake.localhost');
+        $collection = json_decode($writer->getCollection(), true);
+
+        foreach ($expectedRemovedHeaders as $key => $value) {
+            $this->assertNotContains(compact('key', 'value'), data_get($collection, 'item.0.item.0.request.header'));
+        }
+    }
+
+    public function provideAuthConfigHeaderData()
+    {
+        yield [
+            ['type' => 'bearer', 'bearer' => ['token' => 'Test']],
+            ['Authorization' => 'Bearer Test'],
+        ];
+
+        yield [
+            ['type' => 'apikey', 'apikey' => ['value' => 'Test', 'key' => 'X-Authorization']],
+            ['X-Authorization' => 'Test'],
+        ];
+    }
+
+    public function testApiKeyAuthIsIgnoredIfExplicitlyNotInHeader()
+    {
+        \Config::set('apidoc.postman', [
+            'auth' => ['type' => 'apikey', 'apikey' => [
+                'value' => 'Test',
+                'key' => 'X-Authorization',
+                'in' => 'notheader',
+            ]],
+        ]);
+
+        $route = $this->createMockRouteData('some/path');
+        $route['headers'] = ['X-Authorization' => 'Test'];
+        $collection = $this->createMockRouteGroup([$route], 'Group');
+        $writer = new PostmanCollectionWriter($collection, 'fake.localhost');
+        $collection = json_decode($writer->getCollection(), true);
+
+        $this->assertContains([
+            'key' => 'X-Authorization',
+            'value' => 'Test',
+        ], data_get($collection, 'item.0.item.0.request.header'));
+    }
+
+    protected function createMockRouteData($path, $title = '')
+    {
+        return [
+            'uri' => $path,
+            'methods' => ['GET'],
+            'headers' => [],
+            'metadata' => [
+                'groupDescription' => '',
+                'title' => $title,
+            ],
+            'queryParameters' => [],
+            'urlParameters' => [],
+            'cleanBodyParameters' => [],
+        ];
+    }
+
+    protected function createMockRouteGroup(array $routes, $groupName = 'Group')
+    {
+        return collect([$groupName => collect($routes)]);
+    }
+}
diff --git a/tests/Unit/RouteMatcherDingoTest.php b/tests/Unit/RouteMatcherDingoTest.php
new file mode 100644
index 00000000..a85cd496
--- /dev/null
+++ b/tests/Unit/RouteMatcherDingoTest.php
@@ -0,0 +1,310 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests\Unit;
+
+use Dingo\Api\Routing\Router;
+use Illuminate\Support\Str;
+use Mpociot\ApiDoc\Matching\RouteMatcher;
+use Orchestra\Testbench\TestCase;
+
+/**
+ * @group dingo
+ */
+class RouteMatcherDingoTest extends TestCase
+{
+    protected function getPackageProviders($app)
+    {
+        return [
+            "\Dingo\Api\Provider\LaravelServiceProvider",
+        ];
+    }
+
+    public function testRespectsDomainsRuleForDingoRouter()
+    {
+        $this->registerDingoRoutes();
+        $routeRules[0]['match']['versions'] = ['v1'];
+        $routeRules[0]['match']['prefixes'] = ['*'];
+
+        $routeRules[0]['match']['domains'] = ['*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $this->assertCount(12, $routes);
+
+        $routeRules[0]['match']['domains'] = ['domain1.*', 'domain2.*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $this->assertCount(12, $routes);
+
+        $routeRules[0]['match']['domains'] = ['domain1.*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $this->assertCount(6, $routes);
+        foreach ($routes as $route) {
+            $this->assertStringContainsString('domain1', $route['route']->getDomain());
+        }
+
+        $routeRules[0]['match']['domains'] = ['domain2.*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $this->assertCount(6, $routes);
+        foreach ($routes as $route) {
+            $this->assertStringContainsString('domain2', $route['route']->getDomain());
+        }
+    }
+
+    public function testRespectsPrefixesRuleForDingoRouter()
+    {
+        $this->registerDingoRoutes();
+        $routeRules[0]['match']['versions'] = ['v1'];
+        $routeRules[0]['match']['domains'] = ['*'];
+
+        $routeRules[0]['match']['prefixes'] = ['*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $this->assertCount(12, $routes);
+
+        $routeRules[0]['match']['prefixes'] = ['prefix1/*', 'prefix2/*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $this->assertCount(8, $routes);
+
+        $routeRules[0]['match']['prefixes'] = ['prefix1/*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $this->assertCount(4, $routes);
+        foreach ($routes as $route) {
+            $this->assertTrue(Str::is('prefix1/*', $route['route']->uri()));
+        }
+
+        $routeRules[0]['match']['prefixes'] = ['prefix2/*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $this->assertCount(4, $routes);
+        foreach ($routes as $route) {
+            $this->assertTrue(Str::is('prefix2/*', $route['route']->uri()));
+        }
+    }
+
+    public function testRespectsVersionsRuleForDingoRouter()
+    {
+        $this->registerDingoRoutes();
+
+        $routeRules[0]['match']['versions'] = ['v2'];
+        $routeRules[0]['match']['domains'] = ['*'];
+        $routeRules[0]['match']['prefixes'] = ['*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $this->assertCount(6, $routes);
+        foreach ($routes as $route) {
+            $this->assertNotEmpty(array_intersect($route['route']->versions(), ['v2']));
+        }
+
+        $routeRules[0]['match']['versions'] = ['v1', 'v2'];
+        $routeRules[0]['match']['domains'] = ['*'];
+        $routeRules[0]['match']['prefixes'] = ['*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $this->assertCount(18, $routes);
+    }
+
+    public function testWillIncludeRouteIfListedExplicitlyForDingoRouter()
+    {
+        $this->registerDingoRoutes();
+
+        $mustInclude = 'v2.domain2';
+        $routeRules = [
+            [
+                'match' => [
+                    'domains' => ['domain1.*'],
+                    'prefixes' => ['prefix1/*'],
+                    'versions' => ['v1'],
+                ],
+                'include' => [$mustInclude],
+            ],
+        ];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $oddRuleOut = collect($routes)->filter(function ($route) use ($mustInclude) {
+            return $route['route']->getName() === $mustInclude;
+        });
+        $this->assertCount(1, $oddRuleOut);
+    }
+
+    public function testWillIncludeRouteIfMatchForAnIncludePatternForDingoRouter()
+    {
+        $this->registerDingoRoutes();
+
+        $mustInclude = ['v2.domain1', 'v2.domain2'];
+        $includePattern = 'v2.domain*';
+        $routeRules = [
+            [
+                'match' => [
+                    'domains' => ['domain1.*'],
+                    'prefixes' => ['prefix1/*'],
+                    'versions' => ['v1'],
+                ],
+                'include' => [$includePattern],
+            ],
+        ];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $oddRuleOut = collect($routes)->filter(function ($route) use ($mustInclude) {
+            return in_array($route['route']->getName(), $mustInclude);
+        });
+        $this->assertCount(count($mustInclude), $oddRuleOut);
+    }
+
+    public function testWillExcludeRouteIfListedExplicitlyForDingoRouter()
+    {
+        $this->registerDingoRoutes();
+
+        $mustNotInclude = 'v2.domain2';
+        $routeRules = [
+            [
+                'match' => [
+                    'domains' => ['domain2.*'],
+                    'prefixes' => ['*'],
+                    'versions' => ['v2'],
+                ],
+                'exclude' => [$mustNotInclude],
+            ],
+        ];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $oddRuleOut = collect($routes)->filter(function ($route) use ($mustNotInclude) {
+            return $route['route']->getName() === $mustNotInclude;
+        });
+        $this->assertCount(0, $oddRuleOut);
+    }
+
+    public function testWillExcludeRouteIfMatchForAnExcludePatterForDingoRouter()
+    {
+        $this->registerDingoRoutes();
+
+        $mustNotInclude = ['v2.prefix1.domain2', 'v2.prefix2.domain2'];
+        $excludePattern = 'v2.*.domain2';
+        $routeRules = [
+            [
+                'match' => [
+                    'domains' => ['domain2.*'],
+                    'prefixes' => ['*'],
+                    'versions' => ['v2'],
+                ],
+                'exclude' => [$excludePattern],
+            ],
+        ];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $oddRuleOut = collect($routes)->filter(function ($route) use ($mustNotInclude) {
+            return in_array($route['route']->getName(), $mustNotInclude);
+        });
+        $this->assertCount(0, $oddRuleOut);
+    }
+
+    public function testMergesRoutesFromDifferentRuleGroupsForDingoRouter()
+    {
+        $this->registerDingoRoutes();
+        $routeRules = [
+            [
+                'match' => [
+                    'domains' => ['*'],
+                    'prefixes' => ['*'],
+                    'versions' => ['v1'],
+                ],
+            ],
+            [
+                'match' => [
+                    'domains' => ['*'],
+                    'prefixes' => ['*'],
+                    'versions' => ['v2'],
+                ],
+            ],
+        ];
+
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules, 'dingo');
+        $this->assertCount(18, $routes);
+
+        $routes = collect($routes);
+        $firstRuleGroup = $routes->filter(function ($route) {
+            return ! empty(array_intersect($route['route']->versions(), ['v1']));
+        });
+        $this->assertCount(12, $firstRuleGroup);
+
+        $secondRuleGroup = $routes->filter(function ($route) {
+            return ! empty(array_intersect($route['route']->versions(), ['v2']));
+        });
+        $this->assertCount(6, $secondRuleGroup);
+    }
+
+    private function registerDingoRoutes()
+    {
+        $api = app('api.router');
+        $api->version('v1', function (Router $api) {
+            $api->group(['domain' => 'domain1.app.test'], function (Router $api) {
+                $api->post('/domain1-1', function () {
+                    return 'hi';
+                })->name('v1.domain1-1');
+                $api->get('domain1-2', function () {
+                    return 'hi';
+                })->name('v1.domain1-2');
+                $api->get('/prefix1/domain1-1', function () {
+                    return 'hi';
+                })->name('v1.prefix1.domain1-1');
+                $api->get('prefix1/domain1-2', function () {
+                    return 'hi';
+                })->name('v1.prefix1.domain1-2');
+                $api->get('/prefix2/domain1-1', function () {
+                    return 'hi';
+                })->name('v1.prefix2.domain1-1');
+                $api->get('prefix2/domain1-2', function () {
+                    return 'hi';
+                })->name('v1.prefix2.domain1-2');
+            });
+            $api->group(['domain' => 'domain2.app.test'], function (Router $api) {
+                $api->post('/domain2-1', function () {
+                    return 'hi';
+                })->name('v1.domain2-1');
+                $api->get('domain2-2', function () {
+                    return 'hi';
+                })->name('v1.domain2-2');
+                $api->get('/prefix1/domain2-1', function () {
+                    return 'hi';
+                })->name('v1.prefix1.domain2-1');
+                $api->get('prefix1/domain2-2', function () {
+                    return 'hi';
+                })->name('v1.prefix1.domain2-2');
+                $api->get('/prefix2/domain2-1', function () {
+                    return 'hi';
+                })->name('v1.prefix2.domain2-1');
+                $api->get('prefix2/domain2-2', function () {
+                    return 'hi';
+                })->name('v1.prefix2.domain2-2');
+            });
+        });
+        $api->version('v2', function (Router $api) {
+            $api->group(['domain' => 'domain1.app.test'], function (Router $api) {
+                $api->post('/domain1', function () {
+                    return 'hi';
+                })->name('v2.domain1');
+                $api->get('/prefix1/domain1', function () {
+                    return 'hi';
+                })->name('v2.prefix1.domain1');
+                $api->get('/prefix2/domain1', function () {
+                    return 'hi';
+                })->name('v2.prefix2.domain1');
+            });
+            $api->group(['domain' => 'domain2.app.test'], function (Router $api) {
+                $api->post('/domain2', function () {
+                    return 'hi';
+                })->name('v2.domain2');
+                $api->get('/prefix1/domain2', function () {
+                    return 'hi';
+                })->name('v2.prefix1.domain2');
+                $api->get('/prefix2/domain2', function () {
+                    return 'hi';
+                })->name('v2.prefix2.domain2');
+            });
+        });
+    }
+}
diff --git a/tests/Unit/RouteMatcherTest.php b/tests/Unit/RouteMatcherTest.php
new file mode 100644
index 00000000..860ba37f
--- /dev/null
+++ b/tests/Unit/RouteMatcherTest.php
@@ -0,0 +1,222 @@
+<?php
+
+namespace Mpociot\ApiDoc\Tests\Unit;
+
+use Illuminate\Support\Facades\Route as RouteFacade;
+use Illuminate\Support\Str;
+use Mpociot\ApiDoc\Matching\RouteMatcher;
+use Orchestra\Testbench\TestCase;
+
+class RouteMatcherTest extends TestCase
+{
+    public function testRespectsDomainsRuleForLaravelRouter()
+    {
+        $this->registerLaravelRoutes();
+        $routeRules[0]['match']['prefixes'] = ['*'];
+
+        $routeRules[0]['match']['domains'] = ['*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $this->assertCount(12, $routes);
+
+        $routeRules[0]['match']['domains'] = ['domain1.*', 'domain2.*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $this->assertCount(12, $routes);
+
+        $routeRules[0]['match']['domains'] = ['domain1.*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $this->assertCount(6, $routes);
+        foreach ($routes as $route) {
+            $this->assertStringContainsString('domain1', $route['route']->getDomain());
+        }
+
+        $routeRules[0]['match']['domains'] = ['domain2.*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $this->assertCount(6, $routes);
+        foreach ($routes as $route) {
+            $this->assertStringContainsString('domain2', $route['route']->getDomain());
+        }
+    }
+
+    public function testRespectsPrefixesRuleForLaravelRouter()
+    {
+        $this->registerLaravelRoutes();
+        $routeRules[0]['match']['domains'] = ['*'];
+
+        $routeRules[0]['match']['prefixes'] = ['*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $this->assertCount(12, $routes);
+
+        $routeRules[0]['match']['prefixes'] = ['prefix1/*', 'prefix2/*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $this->assertCount(8, $routes);
+
+        $routeRules[0]['match']['prefixes'] = ['prefix1/*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $this->assertCount(4, $routes);
+        foreach ($routes as $route) {
+            $this->assertTrue(Str::is('prefix1/*', $route['route']->uri()));
+        }
+
+        $routeRules[0]['match']['prefixes'] = ['prefix2/*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $this->assertCount(4, $routes);
+        foreach ($routes as $route) {
+            $this->assertTrue(Str::is('prefix2/*', $route['route']->uri()));
+        }
+    }
+
+    public function testWillIncludeRouteIfListedExplicitlyForLaravelRouter()
+    {
+        $this->registerLaravelRoutes();
+        $mustInclude = 'domain1-1';
+        $routeRules[0]['include'] = [$mustInclude];
+
+        $routeRules[0]['match']['domains'] = ['domain1.*'];
+        $routeRules[0]['match']['prefixes'] = ['prefix1/*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $oddRuleOut = collect($routes)->filter(function ($route) use ($mustInclude) {
+            return $route['route']->getName() === $mustInclude;
+        });
+        $this->assertCount(1, $oddRuleOut);
+    }
+
+    public function testWillIncludeRouteIfMatchForAnIncludePatternForLaravelRouter()
+    {
+        $this->registerLaravelRoutes();
+        $mustInclude = ['domain1-1', 'domain1-2'];
+        $includePattern = 'domain1-*';
+        $routeRules[0]['include'] = [$includePattern];
+
+        $routeRules[0]['match']['domains'] = ['domain1.*'];
+        $routeRules[0]['match']['prefixes'] = ['prefix1/*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $oddRuleOut = collect($routes)->filter(function ($route) use ($mustInclude) {
+            return in_array($route['route']->getName(), $mustInclude);
+        });
+        $this->assertCount(count($mustInclude), $oddRuleOut);
+    }
+
+    public function testWillExcludeRouteIfListedExplicitlyForLaravelRouter()
+    {
+        $this->registerLaravelRoutes();
+        $mustNotInclude = 'prefix1.domain1-1';
+        $routeRules[0]['exclude'] = [$mustNotInclude];
+
+        $routeRules[0]['match']['domains'] = ['domain1.*'];
+        $routeRules[0]['match']['prefixes'] = ['prefix1/*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $oddRuleOut = collect($routes)->filter(function ($route) use ($mustNotInclude) {
+            return $route['route']->getName() === $mustNotInclude;
+        });
+        $this->assertCount(0, $oddRuleOut);
+    }
+
+    public function testWillExcludeRouteIfMatchForAnExcludePatternForLaravelRouter()
+    {
+        $this->registerLaravelRoutes();
+        $mustNotInclude = ['prefix1.domain1-1', 'prefix1.domain1-2'];
+        $excludePattern = 'prefix1.domain1-*';
+        $routeRules[0]['exclude'] = [$excludePattern];
+
+        $routeRules[0]['match']['domains'] = ['domain1.*'];
+        $routeRules[0]['match']['prefixes'] = ['prefix1/*'];
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $oddRuleOut = collect($routes)->filter(function ($route) use ($mustNotInclude) {
+            return in_array($route['route']->getName(), $mustNotInclude);
+        });
+        $this->assertCount(0, $oddRuleOut);
+    }
+
+    public function testMergesRoutesFromDifferentRuleGroupsForLaravelRouter()
+    {
+        $this->registerLaravelRoutes();
+
+        $routeRules = [
+            [
+                'match' => [
+                    'domains' => ['domain1.*'],
+                    'prefixes' => ['prefix1/*'],
+                ],
+            ],
+            [
+                'match' => [
+                    'domains' => ['domain2.*'],
+                    'prefixes' => ['prefix2*'],
+                ],
+            ],
+        ];
+
+        $matcher = new RouteMatcher();
+        $routes = $matcher->getRoutes($routeRules);
+        $this->assertCount(4, $routes);
+
+        $routes = collect($routes);
+        $firstRuleGroup = $routes->filter(function ($route) {
+            return Str::is('prefix1/*', $route['route']->uri())
+                && Str::is('domain1.*', $route['route']->getDomain());
+        });
+        $this->assertCount(2, $firstRuleGroup);
+
+        $secondRuleGroup = $routes->filter(function ($route) {
+            return Str::is('prefix2/*', $route['route']->uri())
+                && Str::is('domain2.*', $route['route']->getDomain());
+        });
+        $this->assertCount(2, $secondRuleGroup);
+    }
+
+    private function registerLaravelRoutes()
+    {
+        RouteFacade::group(['domain' => 'domain1.app.test'], function () {
+            RouteFacade::post('/domain1-1', function () {
+                return 'hi';
+            })->name('domain1-1');
+            RouteFacade::get('domain1-2', function () {
+                return 'hi';
+            })->name('domain1-2');
+            RouteFacade::get('/prefix1/domain1-1', function () {
+                return 'hi';
+            })->name('prefix1.domain1-1');
+            RouteFacade::get('prefix1/domain1-2', function () {
+                return 'hi';
+            })->name('prefix1.domain1-2');
+            RouteFacade::get('/prefix2/domain1-1', function () {
+                return 'hi';
+            })->name('prefix2.domain1-1');
+            RouteFacade::get('prefix2/domain1-2', function () {
+                return 'hi';
+            })->name('prefix2.domain1-2');
+        });
+        RouteFacade::group(['domain' => 'domain2.app.test'], function () {
+            RouteFacade::post('/domain2-1', function () {
+                return 'hi';
+            })->name('domain2-1');
+            RouteFacade::get('domain2-2', function () {
+                return 'hi';
+            })->name('domain2-2');
+            RouteFacade::get('/prefix1/domain2-1', function () {
+                return 'hi';
+            })->name('prefix1.domain2-1');
+            RouteFacade::get('prefix1/domain2-2', function () {
+                return 'hi';
+            })->name('prefix1.domain2-2');
+            RouteFacade::get('/prefix2/domain2-1', function () {
+                return 'hi';
+            })->name('prefix2.domain2-1');
+            RouteFacade::get('prefix2/domain2-2', function () {
+                return 'hi';
+            })->name('prefix2.domain2-2');
+        });
+    }
+}