[docs] Creating a new generator

FAQ has been split into multiple smaller documents to better categorize
and allow users to find what they're looking for (in docs folder or in
new website).

Release summary information (versioning strategy and cadence) has been
migrated from the Wiki and clarified a bit.

Also adds copy button for all code snippets in website.

.github/.test/auto-labeler.js

@@ -0,0 +1,117 @@
+let fs   = require('fs');
+let path = require('path');
+let util = require('util');
+let yaml = require('./js-yaml.js');
+let samples = require('./samples.json');
+
+class LabelMatch {
+    constructor (match, label) {
+        this.match = match;
+        this.label = label;
+    }
+}
+
+class FileError {
+    constructor (file, actualLabels, expectedLabels) {
+        this.file = file;
+        this.actual = actualLabels;
+        this.expected = expectedLabels;
+    }
+}
+
+class TextError {
+    constructor (text, actualLabels, expectedLabels) {
+        this.text = text;
+        this.actual = actualLabels;
+        this.expected = expectedLabels;
+    }
+}
+
+let labels = [];
+
+function labelsForFile(file) {
+    let body = fs.readFileSync(file);
+    return labelsForText(body)
+}
+
+function labelsForText(text) {
+    let addLabels = new Set();
+    let body = text;
+    for (const v of labels) {
+        if (v.match.test(body)) {
+            addLabels.add(v.label)
+        }
+        // reset regex state
+        v.match.lastIndex = 0
+    }
+    return addLabels;
+}
+
+try {
+    let config = yaml.safeLoad(fs.readFileSync('../auto-labeler.yml', 'utf8'));
+
+    if (config && config.labels && Object.keys(config.labels).length > 0) {
+        for (const labelName in config.labels) {
+            if (config.labels.hasOwnProperty(labelName)) {
+                let matchAgainst = config.labels[labelName];
+                if (Array.isArray(matchAgainst)) {
+                    matchAgainst.forEach(regex => {
+                        // noinspection JSCheckFunctionSignatures
+                        labels.push(new LabelMatch(new RegExp(regex, 'g'), labelName));
+                    })
+                }
+            }
+        }
+    }
+
+    if (labels.length === 0) {
+        // noinspection ExceptionCaughtLocallyJS
+        throw new Error("Expected to parse config.labels, but failed.")
+    }
+
+    let fileErrors = [];
+    samples.files.forEach(function(tester){
+        let file = path.normalize(path.join('..', '..', 'bin', tester.input));
+        let expectedLabels = new Set(tester.matches);
+        let actualLabels = labelsForFile(file);
+        let difference = new Set([...actualLabels].filter(x => !expectedLabels.has(x)));
+        if (difference.size > 0) {
+            fileErrors.push(new FileError(file, actualLabels, expectedLabels));
+        }
+    });
+
+    let textErrors = [];
+    samples.text.forEach(function(tester){
+        let expectedLabels = new Set(tester.matches);
+        let actualLabels = labelsForText(tester.input);
+        let difference = new Set([...actualLabels].filter(x => !expectedLabels.has(x)));
+        if (difference.size > 0) {
+            textErrors.push(new TextError(tester.input, actualLabels, expectedLabels));
+        }
+    });
+
+    // These are separate (file vs text) in case we want to preview where these would fail in the file. not priority at the moment.
+    if (fileErrors.length > 0) {
+        console.warn('There were %d file tester errors', fileErrors.length);
+        fileErrors.forEach(function(errs) {
+            console.log("file: %j\n  actual: %j\n  expected: %j", errs.file, util.inspect(errs.actual), util.inspect(errs.expected))
+        });
+    }
+
+    if (textErrors.length > 0) {
+        console.warn('There were %d text tester errors', textErrors.length);
+        textErrors.forEach(function(errs){
+            console.log("input: %j\n  actual: %j\n  expected: %j", errs.text, util.inspect(errs.actual), util.inspect(errs.expected))
+        })
+    }
+
+    let totalErrors = fileErrors.length + textErrors.length;
+    if (totalErrors === 0) {
+        console.log('Success!');
+    } else {
+        console.log('Failure: %d total errors', totalErrors);
+    }
+} catch (e) {
+    console.log(e);
+}
+

.github/ISSUE_TEMPLATE/announcement.md

@@ -0,0 +1,10 @@
+---
+name: Announcement
+about: Announcements related to the project
+title: "[Announcement] TITLE"
+labels: Announcement
+assignees: ''
+
+---
+
+

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,54 @@
+---
+name: Bug report
+about: Create a bug report to help us improve
+title: "[BUG] Description"
+labels: 'Issue: Bug'
+assignees: ''
+
+---
+
+<!--
+Please follow the issue template below for bug reports.
+Also please indicate in the issue title which language/library is concerned. Eg:  [BUG][JAVA] Bug generating foo with bar 
+-->
+
+##### Description
+
+<!-- describe what is the question, suggestion or issue and why this is a problem for you. -->
+
+##### openapi-generator version
+
+<!-- which version of openapi-generator are you using, is it a regression? -->
+
+##### OpenAPI declaration file content or url
+
+<!-- if it is a bug, a json or yaml that produces it.
+If you post the code inline, please wrap it with
+```yaml
+(here your code)
+```
+(for YAML code) or
+```json
+(here your code)
+```
+(for JSON code), so it becomes more readable. If it is longer than about ten lines,
+please create a Gist (https://gist.github.com) or upload it somewhere else and
+link it here.
+  -->
+
+##### Command line used for generation
+
+<!-- including the language, libraries and various options -->
+
+##### Steps to reproduce
+
+<!-- unambiguous set of steps to reproduce the bug.-->
+
+##### Related issues/PRs
+
+<!-- has a similar issue/PR been reported/opened before? Please do a search in https://github.com/openapitools/openapi-generator/issues?utf8=%E2%9C%93&q=is%3Aissue%20 -->
+
+##### Suggest a fix
+
+<!-- if you can't fix the bug yourself, perhaps you can point to what might be
+  causing the problem (line of code or commit), or simply make a suggestion -->

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,24 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: "[REQ] Feature Request Description"
+labels: 'Enhancement: Feature'
+assignees: ''
+
+---
+
+### Is your feature request related to a problem? Please describe.
+
+<!-- A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] -->
+
+## Describe the solution you'd like
+
+<!-- A clear and concise description of what you want to happen. -->
+
+## Describe alternatives you've considered
+
+<!-- A clear and concise description of any alternative solutions or features you've considered. -->
+
+## Additional context
+
+<!-- Add any other context or screenshots about the feature request here. -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -2,7 +2,7 @@
 
 - [ ] Read the [contribution guidelines](https://github.com/openapitools/openapi-generator/blob/master/CONTRIBUTING.md).
 - [ ] Ran the shell script under `./bin/` to update Petstore sample so that CIs can verify the change. (For instance, only need to run `./bin/{LANG}-petstore.sh` and `./bin/security/{LANG}-petstore.sh` if updating the {LANG} (e.g. php, ruby, python, etc) code generator or {LANG} client's mustache templates). Windows batch files can be found in `.\bin\windows\`.
-- [ ] Filed the PR against the [correct branch](https://github.com/OpenAPITools/openapi-generator/wiki/Git-Branches): `master`, `3.4.x`, `4.0.x`. Default: `master`.
+- [ ] Filed the PR against the [correct branch](https://github.com/OpenAPITools/openapi-generator/wiki/Git-Branches): `master`~~, `3.4.x`, `4.0.x`~~. Default: `master`.
 - [ ] Copied the [technical committee](https://github.com/openapitools/openapi-generator/#62---openapi-generator-technical-committee) to review the pull request if your PR is targeting a particular programming language.
 
 ### Description of the PR

.github/auto-labeler.yml

@@ -0,0 +1,290 @@
+comment: |
+    👍 Thanks for opening this issue!
+    🏷 I have applied any labels matching special text in your issue.
+
+    The team will review the labels and make any necessary changes.
+labels:
+    'Announcement':
+      - '\s*?\[[Aa]nnouncement\]\s*?'
+    'Breaking change (with fallback)':
+      - '\s*?[bB]reaking [cC]hange [wW]ith [fF]allback\s*?'
+    'Breaking change (without fallback)':
+      - '\s*?[bB]reaking [cC]hange [wW]ithout [fF]allback\s*?'
+    'Client: Ada':
+      - '\s*?\[ada\]\s*?'
+      - '\s*?-[gl] ada(?!-)\b'
+    'Client: Android':
+      - '\s*?\[android\]\s*?'
+      - '\s*?-[gl] android(?!-)\b'
+    'Client: Apex':
+      - '\s*?\[apex\]\s*?'
+      - '\s*?-[gl] apex(?!-)\b'
+    'Client: Bash':
+      - '\s*?\[bash\]\s*?'
+      - '\s*?-[gl] bash(?!-)\b'
+    'Client: C':
+      - '\s*?\[[cC]\]\s*?'
+      - '\s*?-[gl] c(?!-)\b'
+    # 'Client: Ceylon':
+    'Client: C++':
+      - '\s*?\[cpp(-.*)?-client\]\s*?'
+      - '\s*?-[gl] cpp(-.*)?-client\s*?'
+      - '\s*?-[gl] cpp-restsdk(?!-)\b'
+      - '\s*?-[gl] cpp-tizen(?!-)\b'
+    'Client: C-Sharp':
+      - '\s*?-[gl] csharp(?!-)\b'
+      - '\s*?[cC]-[sS]harp [cC]lient\s*?'
+      - '\s*?-[gl] csharp-dotnet2\s*?'
+      - '\s*?-[gl] csharp-refactor?\s*?'
+      - '\s*?\[[Cc]#\]'
+      - '\s*?\[csharp\]\s*?'
+    'Client: Clojure':
+      - '\s*?\[clojure\]\s*?'
+      - '\s*?-[gl] clojure(?!-)\b'
+    # 'Client: Crystal':
+    'Client: Dart':
+      - '\s*?\[dart\]\s*?'
+      - '\s*?-[gl] dart(?!-)\b'
+    'Client: Dukescript':
+      - '\s*?\[dukescript\]\s*?'
+      - '\s*?-g dukescript\s*?'
+    'Client: Eiffel':
+      - '\s*?\[eiffel\]\s*?'
+      - '\s*?-[gl] eiffel(?!-)\b'
+    'Client: Elixir':
+      - '\s*?\[elixir\]\s*?'
+      - '\s*?-[gl] elixir(?!-)\b'
+    'Client: Elm':
+      - '\s*?\[elm\]\s*?'
+      - '\s*?-[gl] elm(?!-)\b'
+    'Client: Erlang':
+      - '\s*?\[erlang(-.*)?-client\]\s*?'
+      - '\s*?-[gl] erlang(-.*)?-client\s*?'
+      - '\s*?\[erlang-proper\]\s*?'
+      - '\s*?-[gl] erlang-proper\s*?'
+    'Client: Flash/ActionScript':
+      - '\s*?\[flash\]\s*?'
+      - '\s*?-[gl] flash(?!-)\b'
+    'Client: Go':
+      - '\s*?\[go\]\s*?'
+      - '\s*?-[gl] go(?!-)\b'
+    'Client: Groovy':
+      - '\s*?\[groovy\]\s*?'
+      - '\s*?-[gl] groovy(?!-)\b'
+    'Client: HTML':
+      - '\s*?\[html[2]?\]\s*?'
+      - '\s*?-[gl] html[2]?\s*?'
+    'Client: Haskell':
+      - '\s*?\[haskell(-.*)?-client\]\s*?'
+      - '\s*?-[gl] haskell(-.*)?-client\s*?'
+    'Client: JMeter':
+      - '\s*?\[jmeter\]\s*?'
+      - '\s*?-[gl] jmeter\s*?'
+    'Client: Java':
+      - '\s*?\[java\]\s*?'
+      - '\s*?-[gl] java(?!-)\b'
+    'Client: JavaScript/Node.js':
+      - '\s*?\[javascript\]\s*?'
+      - '\s*?-[gl] javascript\s*?'
+      - '\s*?-[gl] javascript-(\S)*\s*?'
+    # 'Client: Julia': # NOTE: Not yet implemented
+    'Client: Kotlin':
+      - '\s*?\[kotlin\]\s*?'
+      - '\s*?-[gl] kotlin(?!-)\b'
+    'Client: Lisp':
+      - '\s*?\[lisp\]\s*?'
+      - '\s*?-[gl] lisp(?!-)\b'
+    'Client: Lua':
+      - '\s*?\[lua\]\s*?'
+      - '\s*?-[gl] lua(?!-)\b'
+    'Client: Objc':
+      - '\s*?\[objc\]\s*?'
+      - '\s*?-[gl] objc\s*?'
+    # 'Client: OCaml':
+    'Client: Perl':
+      - '\s*?\[perl\]\s*?'
+      - '\s*?-[gl] perl(?!-)\b'
+    # 'Client: PHP':
+    'Client: PowerShell':
+      - '\s*?\[powershell\]\s*?'
+      - '\s*?-[gl] powershell\s*?'
+    'Client: Python':
+      - '\s*?\[python\]\s*?'
+      - '\s*?-[gl] python(?!-)\b'
+    'Client: QT':
+      - '\s*?\[cpp-qt5-client\]\s*?'
+      - '\s*?-[gl] cpp-qt5-client\s*?'
+    'Client: R':
+      - '\s*?\[[rR]\]\s*?'
+      - '\s*?-[gl] r(?!-)\b'
+    'Client: Reason ML':
+      - '\s*?\[reasonml\]\s*?'
+      - '\s*?-[g] reasonml\s*?'
+    'Client: Retrofit':
+      - '\s*?retrofit.*?\s*?'
+    'Client: Ruby':
+      - '\s*?\[ruby\]\s*?'
+      - '\s*?-[gl] ruby(?!-)\b'
+    'Client: Rust':
+      - '\s*?\[rust\]\s*?'
+      - '\s*?-[gl] rust(?!-)\b'
+    'Client: Scala':
+      - '\s*?\[scalaz\]\s*?'
+      - '\s*?-[gl] scalaz\s*?'
+      - '\s*?\[scala-(?!finch)[a-z]+\]\b'
+      - '\s*?-[gl] scala-(?!finch)[a-z]+?(?!-)\b'
+    'Client: Swift':
+      - '\s*?\[swift[34]+\]\s*?'
+      - '\s*?-[gl] swift[34]+\s*?'
+      - '\s*?-[gl] swift2-deprecated\s*?'
+    'Client: TypeScript':
+      - '\s*?\[typescript-[\-a-z]+\]\s*?'
+      - '\s*?-[gl] typescript-[\-a-z]+\s*?'
+    # 'Client: VB/VB.net': # NOTE: Not yet implemented
+    # 'Client: Visual Basic': # TODO: REMOVE UNUSED LABEL
+    'Config: Apache':
+      - '\s*?\[apache2\]\s*?'
+      - '\s*?-[gl] apache2\s*?'
+    'Docker':
+      - '\s*?\[docker\]\s*?'
+    'Documentation: Cwiki':
+      - '\s*?\[cwiki\]\s*?'
+      - '\s*?-[gl] cwiki\s*?'
+    'Documentation: Dynamic HTML':
+      - '\s*?\[dynamic-html\]\s*?'
+      - '\s*?-[gl] dynamic-html\s*?'
+    'Enhancement: CI/Test':
+      - '\s*?\[ci\]\s*?'
+    'Enhancement: Code format':
+      - '\s*?\[format(ting)?\]\s*?'
+    # 'Enhancement: Compatibility':
+    'Enhancement: Feature':
+      - '\s*?\[feat(ure)?s*?'
+    'Enhancement: General':
+      - '\s*?\[general\]\s*?'
+      - '\s*?\[core\]\s*?'
+    # 'Enhancement: New generator':
+    'Enhancement: Performance':
+      - '\s*?\[perf\]\s*?'
+    # 'Feature List: API clients':
+    # 'Feature List: API documentations':
+    # 'Feature List: API servers':
+    # 'Feature: Authentication':
+    # 'Feature: Composition / Inheritance':
+    # 'Feature: Documentation':
+    # 'Feature: Enum':
+    # 'Feature: Generator':
+    'Feature: OAS 3.0 spec support':
+      - '\s*?\[oas3[\.0]?\]\s*?'
+    # 'General: Awaiting feedback':
+    'General: Discussion':
+      - '\s*?\[discussion\]\s*?'
+    'General: Question':
+      - '\s*?\[question\]\s*?'
+    'General: Suggestion':
+      - '\s*?\[suggestion\]\s*?'
+    'General: Support':
+      - '\s*?\[support\]\s*?'
+    'Issue: Bug':
+      - '\s*?\[bug(s)?\]\s*?'
+      - '\s*?\[fix(es)?\]\s*?'
+    # 'Issue: Invalid spec':
+    # 'Issue: Migration':
+    # 'Issue: Non-operational':
+    # 'Issue: Platform':
+    # 'Issue: Regression':
+    'Issue: Security':
+      - '\s*?\[security\]\s*?'
+    # 'Issue: Unable to reproduce':
+    # 'Issue: Undo changes':
+    # 'Issue: Usage/Installation':
+    # 'Issue: Workaround available':
+    'OpenAPI Generator CLI':
+      - '\s*?\[cli\]\s*?'
+    'OpenAPI Generator Gradle Plugin':
+      - '\s*?\[gradle\]\s*?'
+    'OpenAPI Generator Maven Plugin':
+      - '\s*?\[maven\]\s*?'
+    'OpenAPI Generator Online':
+      - '\s*?\[online\]\s*?'
+    'Schema: MySQL':
+      - '\s*?\[mysql\]\s*?'
+      - '\s*?-[gl] mysql\s*?'
+    'Schema: GraphQL':
+      - '\s*?\[graphql-schema\]\s*?'
+      - '\s*?-[gl] graphql-schema\s*?'
+    'Server: Ada':
+      - '\s*?\[ada(-.*)?-server\]\s*?'
+      - '\s*?-[gl] ada(-.*)?-server\s*?'
+    'Server: C++':
+      - '\s*?\[cpp(-.*)?-server\]\s*?'
+      - '\s*?-[gl] cpp(-.*)?-server\s*?'
+    'Server: C-Sharp':
+      - '\s*?\[aspnetcore\]\s*?'
+      - '\s*?-[gl] aspnetcore\s*?'
+      - '\s*?\[csharp-nancyfx\]\s*?'
+      - '\s*?-[gl] csharp-nancyfx\s*?'
+    # 'Server: Ceylon': # TODO: REMOVE UNUSED LABEL
+    'Server: Eiffel':
+      - '\s*?\[eiffel(-.*)?-server\]\s*?'
+      - '\s*?-[gl] eiffel(-.*)?-server\s*?'
+    'Server: Elixir':
+      - '\s*?\[elixir(-.*)?-server\]\s*?'
+      - '\s*?-[gl] elixir(-.*)?-server\s*?'
+    'Server: Erlang':
+      - '\s*?\[erlang-server\]\s*?'
+      - '\s*?-[gl] erlang-server\s*?'
+    'Server: Go':
+      - '\s*?\[go(-.*)?-server\]\s*?'
+      - '\s*?-[gl] go(-.*)?-server\s*?'
+    'Server: GraphQL':
+      - '\s*?\[graphql(-.*)?-server\]\s*?'
+      - '\s*?-[gl] graphql(-.*)?-server\s*?'
+    'Server: Haskell':
+      - '\s*?\[haskell]\s*?'
+      - '\s*?-[gl] haskell(?!-)\b'
+    'Server: Java':
+      - '\s*?\[java-.*?\]\s*?'
+      - '\s*?-[gl] java-.*?\s*?'
+      - '\s*?-[gl] jaxrx-.*?\s*?'
+    'Server: Kotlin':
+      - '\s*?\[ktor]\s*?'
+      - '\s*?\[kotlin-spring]\s*?'
+      - '\s*?\[kotlin(-.*)?-server\]\s*?'
+      - '\s*?-[gl] kotlin(-.*)?-server\s*?'
+      - '\s*?-[gl] kotlin-spring\s*?'
+    'Server: Nodejs':
+      - '\s*?\[nodejs(-.*)?-server\]\s*?'
+      - '\s*?-[gl] nodejs(-.*)?-server\s*?'
+    'Server: PHP':
+      - '\s*?\[php-.*?\]\s*?'
+      - '\s*?-[gl] php-.*?\s*?'
+    'Server: Perl':
+      - '\s*?\[perl(-.*)?-server\]\s*?'
+      - '\s*?-g perl(-.*)?-server\s*?'
+    'Server: Python':
+      - '\s*?\[python-.*?\]\s*?'
+      - '\s*?-[gl] python-.*?\s*?'
+    'Server: Ruby':
+      - '\s*?\[ruby-.*?\]\s*?'
+      - '\s*?-[gl] ruby-.*?\s*?'
+    'Server: Rust':
+      - '\s*?\[rust(-.*)?-server\]\s*?'
+      - '\s*?-[gl] rust(-.*)?-server\s*?'
+    'Server: Scala':
+      - '\s*?\[scala(-.*)?-server\]\s*?'
+      - '\s*?-[gl] scala(-.*)?-server\s*?'
+      - '\s*?\[scalatra\]\s*?'
+      - '\s*?-[gl] scalatra\s*?'
+      - '\s*?\[scala-finch\]\s*?'
+      - '\s*?-[gl] scala-finch\s*?'
+    'Server: Spring':
+      - '\s*?\[spring\]\s*?'
+      - '\s*?-[g] spring\s*?'
+    # 'Swagger-Parser':
+    'WIP':
+      - '\s*?\[wip\]\s*?'
+      - '\s*?\[WIP\]\s*?'
+      - '\bWIP:.*?'
+    'help wanted':
+      - '\s*?\[help wanted\]\s*?'

.gitignore

@@ -146,6 +146,8 @@ samples/client/petstore/csharp/SwaggerClient/bin/Debug/
 samples/client/petstore/csharp/SwaggerClient/packages
 samples/client/petstore/csharp/SwaggerClient/TestResult.xml
 samples/client/petstore/csharp/SwaggerClientWithPropertyChanged/IO.Swagger.userprefs
+samples/client/petstore/csharp-refactor/OpenAPIClient/TestResult.xml
+samples/client/petstore/csharp-refactor/OpenAPIClient/nuget.exe
 
 # Python
 *.pyc
@@ -178,12 +180,16 @@ samples/client/petstore/kotlin/src/main/kotlin/test/
 samples/client/petstore/kotlin-threetenbp/build
 samples/client/petstore/kotlin-string/build
 samples/server/petstore/kotlin-server/ktor/build
+samples/openapi3/client/petstore/kotlin/build
 \?
 
 # haskell
 .stack-work
 .cabal-sandbox
 cabal.project.local
+samples/client/petstore/haskell-http-client/docs/haddock-bundle.min.js
+samples/client/petstore/haskell-http-client/docs/meta.json
+samples/client/petstore/haskell-http-client/docs/quick-jump.css
 
 # R
 .Rproj.user
@@ -199,6 +205,8 @@ samples/client/petstore/groovy/build
 # erlang
 samples/client/petstore/erlang-client/_build/
 samples/client/petstore/erlang-client/rebar.lock
+samples/client/petstore/erlang-proper/_build/
+samples/client/petstore/erlang-proper/rebar.lock
 samples/server/petstore/erlang-server/_build/
 samples/server/petstore/erlang-server/rebar.lock
 
@@ -212,3 +220,7 @@ samples/client/petstore/javascript/package-lock.json
 
 # elm
 samples/client/petstore/elm/index.html
+
+# C
+samples/client/petstore/c/build
+samples/client/petstore/c/*.so

.travis.yml

@@ -3,7 +3,6 @@ language: java
 jdk:
   - openjdk8
 
-
 cache:
   directories:
   - $HOME/.m2
@@ -34,6 +33,7 @@ cache:
   - $HOME/samples/server/petstore/cpp-pistache/pistache
   - $HOME/.npm  
   - $HOME/.rvm/gems/ruby-2.4.1
+  - $HOME/website/node_modules/
 
 services:
   - docker
@@ -75,11 +75,14 @@ before_install:
   - sudo apt-get install -qq curl
   # install dart
   #- sudo apt-get update
-  - sudo apt-get install apt-transport-https
-  - sudo sh -c 'curl https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add -'
-  - sudo sh -c 'curl https://storage.googleapis.com/download.dartlang.org/linux/debian/dart_stable.list > /etc/apt/sources.list.d/dart_stable.list'
-  - sudo apt-get update
-  - sudo apt-get install dart
+  #- sudo apt-get install apt-transport-https
+  #- sudo sh -c 'curl https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add -'
+  #- sudo sh -c 'curl https://storage.googleapis.com/download.dartlang.org/linux/debian/dart_stable.list > /etc/apt/sources.list.d/dart_stable.list'
+  #- sudo apt-get update
+  #- sudo apt-get install dart
+  # switch to php7
+  - phpenv global 7.1
+  - php -v
   # install perl module
   #- cpanm --local-lib=~/perl5 local::lib && eval $(perl -I ~/perl5/lib/perl5/ -Mlocal::lib)
   #- cpanm Test::Exception Test::More Log::Any LWP::UserAgent JSON URI:Query Module::Runtime DateTime Module::Find Moose::Role
@@ -99,6 +102,7 @@ before_install:
       gpg --keyserver keyserver.ubuntu.com --recv-key $SIGNING_KEY ;
       gpg --check-trustdb ;
     fi;
+  - pushd .; cd website; npm install; popd
 
 install:
   # Add Godeps dependencies to GOPATH and PATH
@@ -109,8 +113,8 @@ install:
   - gcc -v
   - echo $CC
   - echo $CXX
-  - pub version
-  - dart --version
+  #- pub version
+  #- dart --version
 
 script:
   # fail fast
@@ -149,6 +153,15 @@ after_success:
   - if [ $DOCKER_HUB_USERNAME ]; then echo "$DOCKER_HUB_PASSWORD" | docker login --username=$DOCKER_HUB_USERNAME --password-stdin && docker build -t $DOCKER_GENERATOR_IMAGE_NAME ./modules/openapi-generator-online && if [ ! -z "$TRAVIS_TAG" ]; then docker tag $DOCKER_GENERATOR_IMAGE_NAME:latest $DOCKER_GENERATOR_IMAGE_NAME:$TRAVIS_TAG; fi && if [ ! -z "$TRAVIS_TAG" ] || [ "$TRAVIS_BRANCH" = "master" ]; then docker push $DOCKER_GENERATOR_IMAGE_NAME && echo "Pushed to $DOCKER_GENERATOR_IMAGE_NAME"; fi; fi
   ## docker: build cli image and push to Docker Hub
   - if [ $DOCKER_HUB_USERNAME ]; then echo "$DOCKER_HUB_PASSWORD" | docker login --username=$DOCKER_HUB_USERNAME --password-stdin && cp docker-entrypoint.sh ./modules/openapi-generator-cli && docker build -t $DOCKER_CODEGEN_CLI_IMAGE_NAME ./modules/openapi-generator-cli && if [ ! -z "$TRAVIS_TAG" ]; then docker tag $DOCKER_CODEGEN_CLI_IMAGE_NAME:latest $DOCKER_CODEGEN_CLI_IMAGE_NAME:$TRAVIS_TAG; fi && if [ ! -z "$TRAVIS_TAG" ] || [ "$TRAVIS_BRANCH" = "master" ]; then docker push $DOCKER_CODEGEN_CLI_IMAGE_NAME && echo "Pushed to $DOCKER_CODEGEN_CLI_IMAGE_NAME"; fi; fi
+  ## publish latest website, variables below are secure environment variables which are unavailable to PRs from forks.
+  - if [ "$TRAVIS_BRANCH" = "master" ] && [ -z $TRAVIS_TAG ] && [ "$TRAVIS_PULL_REQUEST" == "false" ]; then
+      cd website;
+      git config --global user.name "${GH_NAME}";
+      git config --global user.email "${GH_EMAIL}";
+      echo "machine github.com login ${GH_NAME} password ${GH_TOKEN}" > ~/.netrc;
+      npm install;
+      GIT_USER="${GH_NAME}" npm run-script publish-gh-pages;
+    fi;
 
 env:
   - DOCKER_GENERATOR_IMAGE_NAME=openapitools/openapi-generator-online DOCKER_CODEGEN_CLI_IMAGE_NAME=openapitools/openapi-generator-cli NODE_ENV=test CC=gcc-5 CXX=g++-5

CI/circle_parallel.sh

@@ -15,7 +15,7 @@ elif [ "$NODE_INDEX" = "2" ]; then
   java -version
   #export GO_POST_PROCESS_FILE="/usr/local/bin/gofmt -w"
   # not formatting the code as different go versions may format the code a bit different
-  #./bin/utils/ensure-up-to-date
+  ./bin/utils/ensure-up-to-date
 else
   echo "Running node $NODE_INDEX to test 'samples.circleci.jdk7' defined in pom.xml ..."
   sudo update-java-alternatives -s java-1.7.0-openjdk-amd64

CI/samples.ci/client/petstore/csharp-refactor/OpenAPIClient/src/Org.OpenAPITools.Test/Org.OpenAPITools.Test.csproj

@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+OpenAPI Petstore
+
+This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+
+OpenAPI spec version: 1.0.0
+
+-->
+<Project ToolsVersion="12.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <PropertyGroup>
+    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
+    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
+    <ProjectGuid>{19F1DEBC-DE5E-4517-8062-F000CD499087}</ProjectGuid>
+    <OutputType>Library</OutputType>
+    <AppDesignerFolder>Properties</AppDesignerFolder>
+    <RootNamespace>Org.OpenAPITools.Test</RootNamespace>
+    <AssemblyName>Org.OpenAPITools.Test</AssemblyName>
+    <TargetFrameworkVersion>v4.5.2</TargetFrameworkVersion>
+    <FileAlignment>512</FileAlignment>
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
+    <DebugSymbols>true</DebugSymbols>
+    <DebugType>full</DebugType>
+    <Optimize>false</Optimize>
+    <OutputPath>bin\Debug\</OutputPath>
+    <DefineConstants>DEBUG;TRACE</DefineConstants>
+    <ErrorReport>prompt</ErrorReport>
+    <WarningLevel>4</WarningLevel>
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
+    <DebugType>pdbonly</DebugType>
+    <Optimize>true</Optimize>
+    <OutputPath>bin\Release\</OutputPath>
+    <DefineConstants>TRACE</DefineConstants>
+    <ErrorReport>prompt</ErrorReport>
+    <WarningLevel>4</WarningLevel>
+  </PropertyGroup>
+  <ItemGroup>
+    <Reference Include="System" />
+    <Reference Include="System.Core" />
+    <Reference Include="System.Xml.Linq" />
+    <Reference Include="System.Data.DataSetExtensions" />
+    <Reference Include="System.ComponentModel.DataAnnotations" />
+    <Reference Include="Microsoft.CSharp" />
+    <Reference Include="System.Data" />
+    <Reference Include="System.Runtime.Serialization" />
+    <Reference Include="System.Xml" />
+    <Reference Include="Newtonsoft.Json">
+        <HintPath Condition="Exists('$(SolutionDir)\packages')">$(SolutionDir)\packages\Newtonsoft.Json.12.0.1\lib\net45\Newtonsoft.Json.dll</HintPath>
+        <HintPath Condition="Exists('..\packages')">..\packages\Newtonsoft.Json.12.0.1\lib\net45\Newtonsoft.Json.dll</HintPath>
+        <HintPath Condition="Exists('..\..\packages')">..\..\packages\Newtonsoft.Json.12.0.1\lib\net45\Newtonsoft.Json.dll</HintPath>
+        <HintPath Condition="Exists('..\..\vendor')">..\..\vendor\Newtonsoft.Json.12.0.1\lib\net45\Newtonsoft.Json.dll</HintPath>
+    </Reference>
+    <Reference Include="JsonSubTypes">
+        <HintPath Condition="Exists('$(SolutionDir)\packages')">$(SolutionDir)\packages\JsonSubTypes.1.5.1\lib\net45\JsonSubTypes.dll</HintPath>
+        <HintPath Condition="Exists('..\packages')">..\packages\JsonSubTypes.1.5.1\lib\net45\JsonSubTypes.dll</HintPath>
+        <HintPath Condition="Exists('..\..\packages')">..\..\packages\JsonSubTypes.1.5.1\lib\net45\JsonSubTypes.dll</HintPath>
+        <HintPath Condition="Exists('..\..\vendor')">..\..\vendor\JsonSubTypes.1.5.1\lib\net45\JsonSubTypes.dll</HintPath>
+    </Reference>
+    <Reference Include="RestSharp">
+        <HintPath Condition="Exists('$(SolutionDir)\packages')">$(SolutionDir)\packages\RestSharp.106.5.4\lib\net452\RestSharp.dll</HintPath>
+        <HintPath Condition="Exists('..\packages')">..\packages\RestSharp.106.5.4\lib\net452\RestSharp.dll</HintPath>
+        <HintPath Condition="Exists('..\..\packages')">..\..\packages\RestSharp.106.5.4\lib\net452\RestSharp.dll</HintPath>
+        <HintPath Condition="Exists('..\..\vendor')">..\..\vendor\RestSharp.106.5.4\lib\net452\RestSharp.dll</HintPath>
+    </Reference>
+    <Reference Include="nunit.framework">
+        <HintPath Condition="Exists('$(SolutionDir)\packages')">$(SolutionDir)\packages\NUnit.2.6.4\lib\nunit.framework.dll</HintPath>
+        <HintPath Condition="Exists('..\packages')">..\packages\NUnit.2.6.4\lib\nunit.framework.dll</HintPath>
+        <HintPath Condition="Exists('..\..\packages')">..\..\packages\NUnit.2.6.4\lib\nunit.framework.dll</HintPath>
+        <HintPath Condition="Exists('..\..\vendor')">..\..\vendor\NUnit.2.6.4\lib\nunit.framework.dll</HintPath>
+    </Reference>
+  </ItemGroup>
+  <ItemGroup>
+    <Compile Include="**\*.cs" Exclude="obj\**" />
+  </ItemGroup>
+  <ItemGroup>
+      <None Include="packages.config" />
+  </ItemGroup>
+  <Import Project="$(MsBuildToolsPath)\Microsoft.CSharp.targets" />
+  <ItemGroup>
+      <ProjectReference Include="..\Org.OpenAPITools\Org.OpenAPITools.csproj">
+          <Project>{321C8C3F-0156-40C1-AE42-D59761FB9B6C}</Project>
+          <Name>Org.OpenAPITools</Name>
+      </ProjectReference>
+  </ItemGroup>
+  <ItemGroup>
+    <EmbeddedResource Include="linux-logo.png" />
+  </ItemGroup>
+</Project>
+

CI/samples.ci/client/petstore/java/test-manual/okhttp-gson/model/ArrayOfArrayOfNumberOnlyTest.java

@@ -0,0 +1,70 @@
+/*
+ * OpenAPI Petstore
+ * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+ *
+ * OpenAPI spec version: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+package org.openapitools.client.model;
+
+import org.apache.commons.lang3.builder.EqualsBuilder;
+import com.google.gson.TypeAdapter;
+import com.google.gson.annotations.JsonAdapter;
+import com.google.gson.annotations.SerializedName;
+import com.google.gson.stream.JsonReader;
+import com.google.gson.stream.JsonWriter;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import java.io.IOException;
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.List;
+import org.junit.Assert;
+import org.junit.Ignore;
+import org.junit.Test;
+
+/**
+ * Model tests for ArrayOfArrayOfNumberOnly
+ */
+public class ArrayOfArrayOfNumberOnlyTest {
+    private final ArrayOfArrayOfNumberOnly model = new ArrayOfArrayOfNumberOnly();
+
+    /**
+     * Model tests for ArrayOfArrayOfNumberOnly
+     */
+    @Test
+    public void test() {
+        // TODO: test ArrayOfArrayOfNumberOnly
+    }
+
+    /**
+     * Test the property 'arrayArrayNumber'
+     */
+    @Test
+    public void arrayArrayNumberTest() {
+        BigDecimal b1 = new BigDecimal("12.3");
+        BigDecimal b2 = new BigDecimal("5.6");
+        List<BigDecimal> arrayArrayNumber = new ArrayList<BigDecimal>();
+        arrayArrayNumber.add(b1);
+        arrayArrayNumber.add(b2);
+        model.getArrayArrayNumber().add(arrayArrayNumber);
+
+        // create another instance for comparison
+        BigDecimal b3 = new BigDecimal("12.3");
+        BigDecimal b4 = new BigDecimal("5.6");
+        ArrayOfArrayOfNumberOnly model2 = new ArrayOfArrayOfNumberOnly();
+        List<BigDecimal> arrayArrayNumber2 = new ArrayList<BigDecimal>();
+        arrayArrayNumber2.add(b1);
+        arrayArrayNumber2.add(b2);
+        model2.getArrayArrayNumber().add(arrayArrayNumber2);
+
+        Assert.assertTrue(model2.equals(model));
+    }
+
+}

CI/samples.ci/client/petstore/java/test-manual/okhttp-gson/model/PetTest.java

@@ -0,0 +1,103 @@
+/*
+ * OpenAPI Petstore
+ * This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
+ *
+ * OpenAPI spec version: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+package org.openapitools.client.model;
+
+import com.google.gson.TypeAdapter;
+import com.google.gson.annotations.JsonAdapter;
+import com.google.gson.annotations.SerializedName;
+import com.google.gson.stream.JsonReader;
+import com.google.gson.stream.JsonWriter;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+import org.openapitools.client.model.Category;
+import org.openapitools.client.model.Tag;
+import org.junit.Assert;
+import org.junit.Ignore;
+import org.junit.Test;
+
+
+/**
+ * Model tests for Pet
+ */
+public class PetTest {
+    private final Pet model = new Pet();
+
+    /**
+     * Model tests for Pet
+     */
+    @Test
+    public void testPet() {
+        // test Pet
+        model.setId(1029L);
+        model.setName("Dog");
+
+        Pet model2 = new Pet();
+        model2.setId(1029L);
+        model2.setName("Dog");
+
+        Assert.assertTrue(model.equals(model2));
+    }
+
+    /**
+     * Test the property 'id'
+     */
+    @Test
+    public void idTest() {
+        // TODO: test id
+    }
+
+    /**
+     * Test the property 'category'
+     */
+    @Test
+    public void categoryTest() {
+        // TODO: test category
+    }
+
+    /**
+     * Test the property 'name'
+     */
+    @Test
+    public void nameTest() {
+        // TODO: test name
+    }
+
+    /**
+     * Test the property 'photoUrls'
+     */
+    @Test
+    public void photoUrlsTest() {
+        // TODO: test photoUrls
+    }
+
+    /**
+     * Test the property 'tags'
+     */
+    @Test
+    public void tagsTest() {
+        // TODO: test tags
+    }
+
+    /**
+     * Test the property 'status'
+     */
+    @Test
+    public void statusTest() {
+        // TODO: test status
+    }
+
+}

CI/samples.ci/client/petstore/typescript-fetch/builds/default/pom.xml

@@ -0,0 +1,26 @@
+<project>
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>org.openapitools</groupId>
+    <artifactId>TypeScriptAngularBuildPestoreClientTests</artifactId>
+    <packaging>pom</packaging>
+    <version>1.0-SNAPSHOT</version>
+    <name>TS Fetch Default Petstore Client</name>
+    <build>
+        <plugins>
+            <plugin>
+                <artifactId>maven-dependency-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>copy-dependencies</goal>
+                        </goals>
+                        <configuration>
+                            <outputDirectory>${project.build.directory}</outputDirectory>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

CI/samples.ci/client/petstore/typescript-fetch/builds/es6-target/pom.xml

@@ -0,0 +1,59 @@
+<project>
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>org.openapitools</groupId>
+    <artifactId>TypeScriptAngularBuildES6PestoreClientTests</artifactId>
+    <packaging>pom</packaging>
+    <version>1.0-SNAPSHOT</version>
+    <name>TS Fetch ES6 Petstore Client</name>
+    <build>
+        <plugins>
+            <plugin>
+                <artifactId>maven-dependency-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>copy-dependencies</goal>
+                        </goals>
+                        <configuration>
+                            <outputDirectory>${project.build.directory}</outputDirectory>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>exec-maven-plugin</artifactId>
+                <version>1.2.1</version>
+                <executions>
+                    <execution>
+                        <id>npm-install</id>
+                        <phase>integration-test</phase>
+                        <goals>
+                            <goal>exec</goal>
+                        </goals>
+                        <configuration>
+                            <executable>npm</executable>
+                            <arguments>
+                                <argument>install</argument>
+                            </arguments>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>npm-test</id>
+                        <phase>integration-test</phase>
+                        <goals>
+                            <goal>exec</goal>
+                        </goals>
+                        <configuration>
+                            <executable>npm</executable>
+                            <arguments>
+                                <argument>test</argument>
+                            </arguments>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

CI/samples.ci/client/petstore/typescript-fetch/builds/with-npm-version/pom.xml

@@ -0,0 +1,73 @@
+<project>
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>org.openapitools</groupId>
+    <artifactId>TypeScriptAngularBuildWithNPMVersionPestoreClientTests</artifactId>
+    <packaging>pom</packaging>
+    <version>1.0-SNAPSHOT</version>
+    <name>TS Fetch Petstore Client (with npm)</name>
+    <build>
+        <plugins>
+            <plugin>
+                <artifactId>maven-dependency-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>copy-dependencies</goal>
+                        </goals>
+                        <configuration>
+                            <outputDirectory>${project.build.directory}</outputDirectory>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>exec-maven-plugin</artifactId>
+                <version>1.2.1</version>
+                <executions>
+                    <execution>
+                        <id>npm-install</id>
+                        <phase>integration-test</phase>
+                        <goals>
+                            <goal>exec</goal>
+                        </goals>
+                        <configuration>
+                            <executable>npm</executable>
+                            <arguments>
+                                <argument>install</argument>
+                            </arguments>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>npm-build</id>
+                        <phase>integration-test</phase>
+                        <goals>
+                            <goal>exec</goal>
+                        </goals>
+                        <configuration>
+                            <executable>npm</executable>
+                            <arguments>
+                                <argument>run</argument>
+                                <argument>build</argument>
+                            </arguments>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>npm-test</id>
+                        <phase>integration-test</phase>
+                        <goals>
+                            <goal>exec</goal>
+                        </goals>
+                        <configuration>
+                            <executable>npm</executable>
+                            <arguments>
+                                <argument>test</argument>
+                            </arguments>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

CI/samples.ci/client/petstore/typescript-fetch/tests/default/pom.xml

@@ -0,0 +1,59 @@
+<project>
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>org.openapitools</groupId>
+    <artifactId>TypeScriptFetchPestoreClientTests</artifactId>
+    <packaging>pom</packaging>
+    <version>1.0-SNAPSHOT</version>
+    <name>TS Fetch Petstore Test Client</name>
+    <build>
+        <plugins>
+            <plugin>
+                <artifactId>maven-dependency-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>copy-dependencies</goal>
+                        </goals>
+                        <configuration>
+                            <outputDirectory>${project.build.directory}</outputDirectory>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>exec-maven-plugin</artifactId>
+                <version>1.2.1</version>
+                <executions>
+                    <execution>
+                        <id>npm-install</id>
+                        <phase>pre-integration-test</phase>
+                        <goals>
+                            <goal>exec</goal>
+                        </goals>
+                        <configuration>
+                            <executable>npm</executable>
+                            <arguments>
+                                <argument>install</argument>
+                            </arguments>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>npm-test</id>
+                        <phase>integration-test</phase>
+                        <goals>
+                            <goal>exec</goal>
+                        </goals>
+                        <configuration>
+                            <executable>npm</executable>
+                            <arguments>
+                                <argument>test</argument>
+                            </arguments>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

CI/samples/client/petstore/csharp/OpenAPIClient/src/Org.OpenAPITools.Test/obj/Debug/Org.OpenAPITools.Test.csproj.CoreCompileInputs.cache

@@ -0,0 +1 @@
+c2fcc2ae9693a8e8d02b25e286844aad88188fcb

README.md

@@ -2,20 +2,11 @@
 
 <div align="center">
 
-[Master](https://github.com/OpenAPITools/openapi-generator/tree/master) (`3.3.3`): [![Build Status](https://img.shields.io/travis/OpenAPITools/openapi-generator/master.svg?label=Integration%20Test)](https://travis-ci.org/OpenAPITools/openapi-generator)
+[Master](https://github.com/OpenAPITools/openapi-generator/tree/master) (`4.0.0`): [![Build Status](https://img.shields.io/travis/OpenAPITools/openapi-generator/master.svg?label=Integration%20Test)](https://travis-ci.org/OpenAPITools/openapi-generator)
 [![Integration Test2](https://circleci.com/gh/OpenAPITools/openapi-generator.svg?style=shield)](https://circleci.com/gh/OpenAPITools/openapi-generator)
 [![Run Status](https://api.shippable.com/projects/5af6bf74e790f4070084a115/badge?branch=master)](https://app.shippable.com/github/OpenAPITools/openapi-generator)
 [![Windows Test](https://ci.appveyor.com/api/projects/status/github/openapitools/openapi-generator?branch=master&svg=true&passingText=Windows%20Test%20-%20OK&failingText=Windows%20Test%20-%20Fails)](https://ci.appveyor.com/project/WilliamCheng/openapi-generator-wh2wu)
 
-[`3.4.x`](https://github.com/OpenAPITools/openapi-generator/tree/3.4.x) branch: [![Build Status](https://img.shields.io/travis/OpenAPITools/openapi-generator/3.4.x.svg?label=Integration%20Test)](https://travis-ci.org/OpenAPITools/openapi-generator)
-[![Integration Test2](https://circleci.com/gh/OpenAPITools/openapi-generator/tree/3.4.x.svg?style=shield)](https://circleci.com/gh/OpenAPITools/openapi-generator)
-[![Run Status](https://api.shippable.com/projects/5af6bf74e790f4070084a115/badge?branch=3.4.x)](https://app.shippable.com/github/OpenAPITools/openapi-generator)
-[![Windows Test](https://ci.appveyor.com/api/projects/status/github/openapitools/openapi-generator?branch=3.4.x&svg=true&passingText=Windows%20Test%20-%20OK&failingText=Windows%20Test%20-%20Fails)](https://ci.appveyor.com/project/WilliamCheng/openapi-generator-wh2wu)
-
-[`4.0.x`](https://github.com/OpenAPITools/openapi-generator/tree/4.0.x) branch: [![Build Status](https://img.shields.io/travis/OpenAPITools/openapi-generator/4.0.x.svg?label=Integration%20Test)](https://travis-ci.org/OpenAPITools/openapi-generator)
-[![Integration Test2](https://circleci.com/gh/OpenAPITools/openapi-generator/tree/4.0.x.svg?style=shield)](https://circleci.com/gh/OpenAPITools/openapi-generator)
-[![Run Status](https://api.shippable.com/projects/5af6bf74e790f4070084a115/badge?branch=4.0.x)](https://app.shippable.com/github/OpenAPITools/openapi-generator)
-[![Windows Test](https://ci.appveyor.com/api/projects/status/github/openapitools/openapi-generator?branch=4.0.x&svg=true&passingText=Windows%20Test%20-%20OK&failingText=Windows%20Test%20-%20Fails)](https://ci.appveyor.com/project/WilliamCheng/openapi-generator-wh2wu)
 </div>
 
 <div align="center">
@@ -36,7 +27,7 @@
 
 :notebook_with_decorative_cover: The eBook [A Beginner's Guide to Code Generation for REST APIs](https://gumroad.com/l/swagger_codegen_beginner) is a good starting point for beginners :notebook_with_decorative_cover:
 
-:warning: If the OpenAPI spec, templates or any input (e.g. options, envirionment variables) is obtained from an untrusted source or environment, please make sure you've reviewed these inputs before using OpenAPI Generator to generate the API client, server stub or documentation to avoid potential security issues (e.g. [code injection](https://en.wikipedia.org/wiki/Code_injection)) :warning:
+:warning: If the OpenAPI spec, templates or any input (e.g. options, environment variables) is obtained from an untrusted source or environment, please make sure you've reviewed these inputs before using OpenAPI Generator to generate the API client, server stub or documentation to avoid potential security issues (e.g. [code injection](https://en.wikipedia.org/wiki/Code_injection)) :warning:
 
 :bangbang: Both "OpenAPI Tools" (https://OpenAPITools.org - the parent organization of OpenAPI Generator) and "OpenAPI Generator" are not affiliated with OpenAPI Initiative (OAI) :bangbang:
 
@@ -47,11 +38,11 @@ OpenAPI Generator allows generation of API client libraries (SDK generation), se
 
 |                                | Languages/Frameworks |
 |-|-|
-**API clients**                  | **ActionScript**, **Ada**, **Apex**, **Bash**, **C#** (.net 2.0, 3.5 or later), **C++** (cpprest, Qt5, Tizen), **Clojure**, **Dart (1.x, 2.x)**, **Elixir**, **Elm**, **Eiffel**, **Erlang**, **Go**, **Groovy**, **Haskell** (http-client, Servant), **Java** (Jersey1.x, Jersey2.x, OkHttp, Retrofit1.x, Retrofit2.x, Feign, RestTemplate, RESTEasy, Vertx, Google API Client Library for Java, Rest-assured, Spring 5 Web Client), **Kotlin**, **Lua**, **Node.js** (ES5, ES6, AngularJS with Google Closure Compiler annotations, Flow types) **Objective-C**, **Perl**, **PHP**, **PowerShell**, **Python**, **R**, **Ruby**, **Rust** (rust, rust-server), **Scala** (akka, http4s, scalaz, swagger-async-httpclient), **Swift** (2.x, 3.x, 4.x), **Typescript** (AngularJS, Angular (2.x - 7.x), Aurelia, Axios, Fetch, Inversify, jQuery, Node)
+**API clients**                  | **ActionScript**, **Ada**, **Apex**, **Bash**, **C**, **C#** (.net 2.0, 3.5 or later), **C++** (cpprest, Qt5, Tizen), **Clojure**, **Dart (1.x, 2.x)**, **Elixir**, **Elm**, **Eiffel**, **Erlang**, **Go**, **Groovy**, **Haskell** (http-client, Servant), **Java** (Jersey1.x, Jersey2.x, OkHttp, Retrofit1.x, Retrofit2.x, Feign, RestTemplate, RESTEasy, Vertx, Google API Client Library for Java, Rest-assured, Spring 5 Web Client), **Kotlin**, **Lua**, **Node.js** (ES5, ES6, AngularJS with Google Closure Compiler annotations, Flow types) **Objective-C**, **Perl**, **PHP**, **PowerShell**, **Python**, **R**, **Ruby**, **Rust** (rust, rust-server), **Scala** (akka, http4s, scalaz, swagger-async-httpclient), **Swift** (2.x, 3.x, 4.x), **Typescript** (AngularJS, Angular (2.x - 7.x), Aurelia, Axios, Fetch, Inversify, jQuery, Node)
 **Server stubs**                 | **Ada**, **C#** (ASP.NET Core, NancyFx), **C++** (Pistache, Restbed), **Erlang**, **Go** (net/http, Gin), **Haskell** (Servant), **Java** (MSF4J, Spring, Undertow, JAX-RS: CDI, CXF, Inflector, RestEasy, Play Framework, [PKMST](https://github.com/ProKarma-Inc/pkmst-getting-started-examples)), **Kotlin** (Spring Boot), **PHP** (Laravel, Lumen, Slim, Silex, [Symfony](https://symfony.com/), [Zend Expressive](https://github.com/zendframework/zend-expressive)), **Python** (Flask), **NodeJS**, **Ruby** (Sinatra, Rails5), **Rust** (rust-server), **Scala** ([Finch](https://github.com/finagle/finch), [Lagom](https://github.com/lagom/lagom), Scalatra)
 **API documentation generators** | **HTML**, **Confluence Wiki**
 **Configuration files**          | [**Apache2**](https://httpd.apache.org/)
-**Others**                       | **JMeter**, **MySQL Schema**
+**Others**                       | **GraphQL**, **JMeter**, **MySQL Schema**
 
 ## Table of contents
 
@@ -88,10 +79,8 @@ The OpenAPI Specification has undergone 3 revisions since initial creation in 20
 
 OpenAPI Generator Version    | Release Date | Notes
 ---------------------------- | ------------ | -----
-4.0.0 (upcoming major release) [SNAPSHOT](https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/4.0.0-SNAPSHOT/)| TBD | Major release with breaking changes (no fallback)
-3.4.0 (upcoming minor release) [SNAPSHOT](https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/3.4.0-SNAPSHOT/)| 01.11.2018 | Minor release (breaking changes with fallbacks)
-3.3.3 (current master, upcoming patch release) [SNAPSHOT](https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/3.3.3-SNAPSHOT/) | 15.11.2018 | Bugfix release
-[3.3.3](https://github.com/OpenAPITools/openapi-generator/releases/tag/v3.3.3) (latest stable release) | 15.11.2018 | Bugfix release
+4.0.0 (upcoming release) [SNAPSHOT](https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/4.0.0-SNAPSHOT/)| 20.12.2018 | Major release with breaking changes (with or without fallback)
+[3.3.4](https://github.com/OpenAPITools/openapi-generator/releases/tag/v3.3.4) (latest stable release) | 30.11.2018 | Bugfix release
 
 OpenAPI Spec compatibility: 1.0, 1.1, 1.2, 2.0, 3.0
 
@@ -99,7 +88,7 @@ For old releases, please refer to the [**Release**](https://github.com/OpenAPITo
 
 ## [1.2 - Artifacts on Maven Central](#table-of-contents)
 
-You can find our released artefacts on maven central:
+You can find our released artifacts on maven central:
 
 **Core:**
 ```xml
@@ -147,16 +136,16 @@ See the different versions of the [openapi-generator-cli](https://mvnrepository.
 
 If you're looking for the latest stable version, you can grab it directly from Maven.org (Java 8 runtime at a minimum):
 
-JAR location: `http://central.maven.org/maven2/org/openapitools/openapi-generator-cli/3.3.3/openapi-generator-cli-3.3.3.jar`
+JAR location: `http://central.maven.org/maven2/org/openapitools/openapi-generator-cli/3.3.4/openapi-generator-cli-3.3.4.jar`
 
 For **Mac/Linux** users:
 ```sh
-wget http://central.maven.org/maven2/org/openapitools/openapi-generator-cli/3.3.3/openapi-generator-cli-3.3.3.jar -O openapi-generator-cli.jar
+wget http://central.maven.org/maven2/org/openapitools/openapi-generator-cli/3.3.4/openapi-generator-cli-3.3.4.jar -O openapi-generator-cli.jar
 ```
 
 For **Windows** users, you will need to install [wget](http://gnuwin32.sourceforge.net/packages/wget.htm) or you can use Invoke-WebRequest in PowerShell (3.0+), e.g.
 ```
-Invoke-WebRequest -OutFile openapi-generator-cli.jar http://central.maven.org/maven2/org/openapitools/openapi-generator-cli/3.3.3/openapi-generator-cli-3.3.3.jar
+Invoke-WebRequest -OutFile openapi-generator-cli.jar http://central.maven.org/maven2/org/openapitools/openapi-generator-cli/3.3.4/openapi-generator-cli-3.3.4.jar
 ```
 
 After downloading the JAR, run `java -jar openapi-generator-cli.jar help` to show the usage.
@@ -216,7 +205,7 @@ To build from source, you need the following installed and available in your `$P
 
 * [Java 8](http://java.oracle.com)
 
-* [Apache maven 3.3.3 or greater](http://maven.apache.org/)
+* [Apache maven 3.3.4 or greater](http://maven.apache.org/)
 
 After cloning the project, you can build it from source with this command:
 ```sh
@@ -285,13 +274,13 @@ GEN_IP=$(docker inspect --format '{{.NetworkSettings.IPAddress}}'  $CID)
 -d '{"openAPIUrl": "https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml"}' \
 'http://localhost:8888/api/gen/clients/ruby'
 
-{"code":"c2d483d3-3672-40e9-91df-b9ffd18d22b8","link":"http://localhost:8888/api/gen/download/c2d483d3-3672-40e9-91df-b9ffd18d22b8"}
+{"code":"c2d483.3.4672-40e9-91df-b9ffd18d22b8","link":"http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8"}
 
 # Download the generated zip file  
-> wget http://localhost:8888/api/gen/download/c2d483d3-3672-40e9-91df-b9ffd18d22b8
+> wget http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8
 
 # Unzip the file
-> unzip c2d483d3-3672-40e9-91df-b9ffd18d22b8
+> unzip c2d483.3.4672-40e9-91df-b9ffd18d22b8
 
 # Shutdown the openapi generator image
 > docker stop $CID && docker rm $CID
@@ -349,20 +338,26 @@ cd /vagrant
 
 ### [1.7 - NPM](#table-of-contents)
 
-There is also an [NPM package wrapper](https://github.com/HarmoWatch/openapi-generator-cli), available.
-Please see the [docs](https://github.com/HarmoWatch/openapi-generator-cli) there for more information.
+There is also an [NPM package wrapper](https://www.npmjs.com/package/@openapitools/openapi-generator-cli) available for different platforms (e.g. Linux, Mac, Windows). (JVM is still required)
+Please see the [project's README](https://github.com/openapitools/openapi-generator-cli) there for more information.
 
 Install it globally to get the CLI available on the command line:
 
 ```sh
-npm install @harmowatch/openapi-generator-cli -g
+npm install @openapitools/openapi-generator-cli -g
 openapi-generator version
 ```
 
-Or you install it as dev-dependency like this:
+Or install a particualar OpenAPI Generator version (e.g. v3.3.4):
 
 ```sh
-npm install @harmowatch/openapi-generator-cli -D
+npm install @openapitools/openapi-generator-cli@cli-3.3.4 -g
+```
+
+Or install it as dev-dependency:
+
+```sh
+npm install @openapitools/openapi-generator-cli -D
 ```
 
 ## [2 - Getting Started](#table-of-contents)
@@ -430,7 +425,6 @@ SYNOPSIS
                 [--import-mappings <import mappings>...]
                 [--instantiation-types <instantiation types>...]
                 [--invoker-package <invoker package>]
-                [(-l <language> | --lang <language>)]
                 [--language-specific-primitives <language specific primitives>...]
                 [--library <library>] [--log-to-stderr]
                 [--model-name-prefix <model name prefix>]
@@ -470,7 +464,7 @@ Other languages have petstore samples, too:
 ./bin/objc-petstore.sh
 ```
 
-... and others. [Here is a list of all scripts.](wiki/Samples-folder#scripts)
+... and others. [Here is a list of all scripts.](https://github.com/OpenAPITools/openapi-generator/wiki/Samples-folder#scripts)
 
 ### [3.1 - Customization](#table-of-contents)
 
@@ -482,6 +476,15 @@ Please refer to [integration.md](docs/integration.md) on how to integrate OpenAP
 
 ### [3.3 - Online OpenAPI generator](#table-of-contents)
 
+Here are the public online services:
+
+- latest stable version: http://api.openapi-generator.tech
+- latest master: http://api-latest-master.openapi-generator.tech (updated with latest master every hour)
+
+The server is sponsored by [Linode](https://www.linode.com/) [![Linode Logo](https://www.linode.com/media/images/logos/standard/light/linode-logo_standard_light_small.png)](https://www.linode.com/)
+
+(These services are beta and do not have any guarantee on service level)
+
 Please refer to [online-openapi-generator.md](docs/online-openapi-generator.md) on how to run and use the `openapi-generator-online` - a web service for `openapi-generator`.
 
 ### [3.4 - License information on Generated Code](#table-of-contents)
@@ -497,17 +500,22 @@ When code is generated from this project, it shall be considered **AS IS** and o
 Here are some companies/projects (alphabetical order) using OpenAPI Generator in production. To add your company/project to the list, please visit [README.md](README.md) and click on the icon to edit the page.
 
 - [Angular.Schule](https://angular.schule/)
+- [ASKUL](https://www.askul.co.jp)
+- [b<>com](https://b-com.com/en)
 - [Bithost GmbH](https://www.bithost.ch)
 - [Boxever](https://www.boxever.com/)
 - [GMO Pepabo](https://pepabo.com/en/)
 - [JustStar](https://www.juststarinfo.com)
 - [Klarna](https://www.klarna.com/)
+- [Metaswitch](https://www.metaswitch.com/)
 - [Myworkout](https://myworkout.com)
 - [Raiffeisen Schweiz Genossenschaft](https://www.raiffeisen.ch)
 - [RepreZen API Studio](https://www.reprezen.com/swagger-openapi-code-generation-api-first-microservices-enterprise-development)
 - [REST United](https://restunited.com)
+- [Stingray](http://www.stingray.com)
 - [Suva](https://www.suva.ch/)
 - [Telstra](https://dev.telstra.com)
+- [TUI InfoTec GmbH](http://www.tui-infotec.com/)
 - [unblu inc.](https://www.unblu.com/)
 - [Zalando](https://www.zalando.com)
 
@@ -523,7 +531,7 @@ Here are some companies/projects (alphabetical order) using OpenAPI Generator in
 - 2018/08/22 - [OpenAPI Generatorのプロジェクト構成などのメモ](https://yinm.info/20180822/) by [Yusuke Iinuma](https://github.com/yinm)
 - 2018/10/31 - [A node package wrapper for openapi-generator](https://github.com/HarmoWatch/openapi-generator-cli)
 - 2018/11/03 - [OpenAPI Generator + golang + Flutter でアプリ開発](http://ryuichi111std.hatenablog.com/entry/2018/11/03/214005) by [Ryuichi Daigo](https://github.com/ryuichi111)
-
+- 2018/11/19 - [OpenAPIs are everywhere](https://youtu.be/-lDot4Yn7Dg) by [Jeremie Bresson (Unblu)](https://github.com/jmini) at [EclipseCon Europe 2018](https://www.eclipsecon.org/europe2018)
 
 ## [6 - About Us](#table-of-contents)
 
@@ -547,6 +555,7 @@ Here is a list of template creators:
    * Akka-Scala: @cchafer
    * Apex: @asnelling
    * Bash: @bkryza
+   * C: @PowerOfCreation @zhemant
    * C++ REST: @Danielku15
    * C# (.NET 2.0): @who
    * C# (.NET Standard 1.3 ): @Gronsak
@@ -610,6 +619,7 @@ Here is a list of template creators:
    * Erlang Server: @galaxie
    * Go Server: @guohuang
    * Go (Gin) Server: @kemokemo
+   * GraphQL Express Server: @renepardon
    * Haskell Servant: @algas
    * Java MSF4J: @sanjeewa-malalgoda
    * Java Spring Boot: @diyfr
@@ -637,6 +647,7 @@ Here is a list of template creators:
  * Configuration
    * Apache2: @stkrwork
  * Schema
+   * GraphQL: @wing328
    * MySQL: @ybelenko
 
 #### How to join the core team
@@ -675,6 +686,7 @@ If you want to join the committee, please kindly apply by sending an email to te
 | Android   | @jaz-ah (2017/09) |
 | Apex      |  |
 | Bash      | @frol (2017/07) @bkryza (2017/08) @kenjones-cisco (2017/09) |
+| C         | @zhemant (2018/11) |
 | C++       | @ravinikam (2017/07) @stkrwork (2017/07) @fvarose (2017/11) @etherealjoy (2018/02) @martindelille (2018/03) |
 | C#        | @mandrean (2017/08) @jimschubert (2017/09) |
 | Clojure   |  |
@@ -684,6 +696,7 @@ If you want to join the committee, please kindly apply by sending an email to te
 | Elm       | @trenneman (2018/09) |
 | Erlang    | @tsloughter (2017/11) @jfacorro (2018/10) @robertoaloi (2018/10) |
 | Go        | @antihax (2017/11) @bvwells (2017/12) @grokify (2018/07) @kemokemo (2018/09 |
+| GraphQL   | @renepardon (2018/12) |
 | Groovy    |  |
 | Haskell   |  |
 | Java      | @bbdouglas (2017/07) @JFCote (2017/08) @sreeshas (2017/08) @jfiala (2017/08) @lukoyanov (2017/09) @cbornet (2017/09) @jeff9finger (2018/01) |
@@ -692,7 +705,7 @@ If you want to join the committee, please kindly apply by sending an email to te
 | NodeJS/Javascript | @CodeNinjai (2017/07) @frol (2017/07) @cliffano (2017/07) |
 | ObjC      |  |
 | Perl      | @wing328 (2017/07) |
-| PHP       | @jebentier (2017/07) @dkarlovi (2017/07) @mandrean (2017/08) @jfastnacht (2017/09) @ackintosh (2017/09) @ybelenko (2018/07) |
+| PHP       | @jebentier (2017/07) @dkarlovi (2017/07) @mandrean (2017/08) @jfastnacht (2017/09) @ackintosh (2017/09) @ybelenko (2018/07) @renepardon (2018/12) |
 | PowerShell | |
 | Python    | @taxpon (2017/07) @frol (2017/07) @mbohlool (2017/07) @cbornet (2017/09) @kenjones-cisco (2017/11) @tomplus (2018/10) |
 | R         |  |

appveyor.yml

@@ -23,6 +23,9 @@ install:
   - git clone https://github.com/wing328/swagger-samples
   - ps: Start-Process -FilePath 'C:\maven\apache-maven-3.2.5\bin\mvn' -ArgumentList 'jetty:run' -WorkingDirectory "$env:appveyor_build_folder\swagger-samples\java\java-jersey-jaxrs-ci"
 build_script:
+  # build C# API client (refactor)
+  - nuget restore samples\client\petstore\csharp-refactor\OpenAPIClient\Org.OpenAPITools.sln
+  - msbuild samples\client\petstore\csharp-refactor\OpenAPIClient\Org.OpenAPITools.sln /logger:"C:\Program Files\AppVeyor\BuildAgent\Appveyor.MSBuildLogger.dll"
   # build C# API client
   - nuget restore samples\client\petstore\csharp\OpenAPIClient\Org.OpenAPITools.sln
   - msbuild samples\client\petstore\csharp\OpenAPIClient\Org.OpenAPITools.sln /logger:"C:\Program Files\AppVeyor\BuildAgent\Appveyor.MSBuildLogger.dll"
@@ -37,6 +40,8 @@ build_script:
 test_script:
   # restore test-related files
   - copy /b/v/y CI\samples.ci\client\petstore\csharp\OpenAPIClient\src\Org.OpenAPITools.Test\Org.OpenAPITools.Test.csproj samples\client\petstore\csharp\OpenAPIClient\src\Org.OpenAPITools.Test\Org.OpenAPITools.Test.csproj
+  # test c# API client (refactor)
+  - nunit-console samples\client\petstore\csharp-refactor\OpenAPIClient\src\Org.OpenAPITools.Test\bin\Debug\Org.OpenAPITools.Test.dll --result=myresults.xml;format=AppVeyor
   # test c# API client
   - nunit-console samples\client\petstore\csharp\OpenAPIClient\src\Org.OpenAPITools.Test\bin\Debug\Org.OpenAPITools.Test.dll --result=myresults.xml;format=AppVeyor
   # test c# API client (with PropertyChanged)

bin/c-petstore.sh

@@ -0,0 +1,32 @@
+#!/bin/sh
+
+SCRIPT="$0"
+echo "# START SCRIPT: $SCRIPT"
+
+while [ -h "$SCRIPT" ] ; do
+  ls=`ls -ld "$SCRIPT"`
+  link=`expr "$ls" : '.*-> \(.*\)$'`
+  if expr "$link" : '/.*' > /dev/null; then
+    SCRIPT="$link"
+  else
+    SCRIPT=`dirname "$SCRIPT"`/"$link"
+  fi
+done
+
+if [ ! -d "${APP_DIR}" ]; then
+  APP_DIR=`dirname "$SCRIPT"`/..
+  APP_DIR=`cd "${APP_DIR}"; pwd`
+fi
+
+executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+
+if [ ! -f "$executable" ]
+then
+  mvn -B clean package
+fi
+
+# if you've executed sbt assembly previously it will use that instead.
+export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
+ags="generate -t modules/openapi-generator/src/main/resources/C-libcurl -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g c -o samples/client/petstore/c $@"
+
+java $JAVA_OPTS -jar $executable $ags

bin/cpp-qt5-petstore.sh

@@ -27,6 +27,6 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/cpp-qt5-client -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g cpp-qt5 -o samples/client/petstore/cpp-qt5 $@"
+ags="generate -t modules/openapi-generator/src/main/resources/cpp-qt5-client -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g cpp-qt5-client -o samples/client/petstore/cpp-qt5 $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/csharp-refactor-petstore.sh

@@ -27,11 +27,11 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml -g csharp-refactor -o samples/client/petstore/csharp-refactor/OpenAPIClient --additional-properties packageGuid={321C8C3F-0156-40C1-AE42-D59761FB9B6C} $@"
+ags="generate -t modules/openapi-generator/src/main/resources/csharp-refactor/ -i modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml -g csharp-refactor -o samples/client/petstore/csharp-refactor/OpenAPIClient --additional-properties packageGuid={321C8C3F-0156-40C1-AE42-D59761FB9B6C},useCompareNetObjects=true $@"
 
 java $JAVA_OPTS -jar $executable $ags
 
 # restore csproj file
-#echo "restore csproject file: CI/samples/client/petstore/csharp/OpenAPIClient/src/Org.OpenAPITools.Test/Org.OpenAPITools.Test.csproj"
-#cp ./CI/samples.ci/client/petstore/csharp/OpenAPIClient/src/Org.OpenAPITools.Test/Org.OpenAPITools.Test.csproj ./samples/client/petstore/csharp-refactor/OpenAPIClient/src/Org.OpenAPITools.Test/
+echo "restore csproject file: CI/samples/client/petstore/csharp-refactor/OpenAPIClient/src/Org.OpenAPITools.Test/Org.OpenAPITools.Test.csproj"
+cp ./CI/samples.ci/client/petstore/csharp-refactor/OpenAPIClient/src/Org.OpenAPITools.Test/Org.OpenAPITools.Test.csproj ./samples/client/petstore/csharp-refactor/OpenAPIClient/src/Org.OpenAPITools.Test/
 

bin/cwiki-petstore.sh

@@ -27,6 +27,6 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g cwiki -o samples/documentation/cwiki $@"
+ags="generate -t modules/openapi-generator/src/main/resources/confluenceWikiDocs -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g cwiki -o samples/documentation/cwiki $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/dart-jaguar-petstore.sh

@@ -28,11 +28,11 @@ fi
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
 
 # Generate client
-ags="$@ generate -t modules/openapi-generator/src/main/resources/dart-jaguar -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -l dart-jaguar -o samples/client/petstore/dart-jaguar/openapi -DhideGenerationTimestamp=true -DpubName=openapi"
+ags="$@ generate -t modules/openapi-generator/src/main/resources/dart-jaguar -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g dart-jaguar -o samples/client/petstore/dart-jaguar/openapi -DhideGenerationTimestamp=true -DpubName=openapi"
 java $JAVA_OPTS -jar $executable $ags
 
 # Generate non-browserClient and put it to the flutter sample app
-ags="$@ generate -t modules/openapi-generator/src/main/resources/dart-jaguar -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -l dart-jaguar -o samples/client/petstore/dart-jaguar/flutter_petstore/openapi -DhideGenerationTimestamp=true -DpubName=openapi"
+ags="$@ generate -t modules/openapi-generator/src/main/resources/dart-jaguar -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g dart-jaguar -o samples/client/petstore/dart-jaguar/flutter_petstore/openapi -DhideGenerationTimestamp=true -DpubName=openapi"
 java $JAVA_OPTS -jar $executable $ags
 
 # There is a proposal to allow importing different libraries depending on the environment:

bin/graphql-schema-petstore.sh

@@ -0,0 +1,32 @@
+#!/bin/sh
+
+SCRIPT="$0"
+echo "# START SCRIPT: $SCRIPT"
+
+while [ -h "$SCRIPT" ] ; do
+  ls=`ls -ld "$SCRIPT"`
+  link=`expr "$ls" : '.*-> \(.*\)$'`
+  if expr "$link" : '/.*' > /dev/null; then
+    SCRIPT="$link"
+  else
+    SCRIPT=`dirname "$SCRIPT"`/"$link"
+  fi
+done
+
+if [ ! -d "${APP_DIR}" ]; then
+  APP_DIR=`dirname "$SCRIPT"`/..
+  APP_DIR=`cd "${APP_DIR}"; pwd`
+fi
+
+executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+
+if [ ! -f "$executable" ]
+then
+  mvn -B clean package
+fi
+
+# if you've executed sbt assembly previously it will use that instead.
+export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties $@"
+ags="generate -t modules/openapi-generator/src/main/resources/graphql-schema -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g graphql-schema -o samples/config/petstore/graphql-schema -DpackageName=petstore $@"
+
+java $JAVA_OPTS -jar $executable $ags

bin/graphql-server-petstore.sh

@@ -0,0 +1,32 @@
+#!/bin/sh
+
+SCRIPT="$0"
+echo "# START SCRIPT: $SCRIPT"
+
+while [ -h "$SCRIPT" ] ; do
+  ls=`ls -ld "$SCRIPT"`
+  link=`expr "$ls" : '.*-> \(.*\)$'`
+  if expr "$link" : '/.*' > /dev/null; then
+    SCRIPT="$link"
+  else
+    SCRIPT=`dirname "$SCRIPT"`/"$link"
+  fi
+done
+
+if [ ! -d "${APP_DIR}" ]; then
+  APP_DIR=`dirname "$SCRIPT"`/..
+  APP_DIR=`cd "${APP_DIR}"; pwd`
+fi
+
+executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+
+if [ ! -f "$executable" ]
+then
+  mvn -B clean package
+fi
+
+# if you've executed sbt assembly previously it will use that instead.
+export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties $@"
+ags="generate -t modules/openapi-generator/src/main/resources/graphql-server -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g graphql-server -o samples/server/petstore/graphql-server -DpackageName=petstore $@"
+
+java $JAVA_OPTS -jar $executable $ags

bin/html-petstore.sh

@@ -27,6 +27,6 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g html  -o samples/documentation/html $@"
+ags="generate -t modules/openapi-generator/src/main/resources/htmlDocs -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g html  -o samples/documentation/html $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/java-petstore-okhttp-gson.sh

@@ -44,4 +44,6 @@ cp CI/samples.ci/client/petstore/java/test-manual/common/ConfigurationTest.java
 cp CI/samples.ci/client/petstore/java/test-manual/okhttp-gson/auth/ApiKeyAuthTest.java samples/client/petstore/java/okhttp-gson/src/test/java/org/openapitools/client/auth/ApiKeyAuthTest.java
 cp CI/samples.ci/client/petstore/java/test-manual/okhttp-gson/auth/HttpBasicAuthTest.java samples/client/petstore/java/okhttp-gson/src/test/java/org/openapitools/client/auth/HttpBasicAuthTest.java
 cp CI/samples.ci/client/petstore/java/test-manual/okhttp-gson/model/EnumValueTest.java samples/client/petstore/java/okhttp-gson/src/test/java/org/openapitools/client/model/EnumValueTest.java
+cp CI/samples.ci/client/petstore/java/test-manual/okhttp-gson/model/PetTest.java samples/client/petstore/java/okhttp-gson/src/test/java/org/openapitools/client/model/PetTest.java
+cp CI/samples.ci/client/petstore/java/test-manual/okhttp-gson/model/ArrayOfArrayOfNumberOnly.java samples/client/petstore/java/okhttp-gson/src/test/java/org/openapitools/client/model/ArrayOfArrayOfNumberOnlyTest.java
 cp CI/samples.ci/client/petstore/java/test-manual/okhttp-gson/JSONTest.java samples/client/petstore/java/okhttp-gson/src/test/java/org/openapitools/client/JSONTest.java

bin/openapi3/cpp-qt5-petstore.sh

@@ -27,6 +27,6 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/cpp-qt5-client -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml -g cpp-qt5 -o samples/client/petstore/cpp-qt5 $@"
+ags="generate -t modules/openapi-generator/src/main/resources/cpp-qt5-client -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml -g cpp-qt5-client -o samples/client/petstore/cpp-qt5 $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/openapi3/graphql-petstore-server.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+
+SCRIPT="$0"
+echo "# START SCRIPT: $SCRIPT"
+
+while [ -h "$SCRIPT" ] ; do
+  ls=`ls -ld "$SCRIPT"`
+  link=`expr "$ls" : '.*-> \(.*\)$'`
+  if expr "$link" : '/.*' > /dev/null; then
+    SCRIPT="$link"
+  else
+    SCRIPT=`dirname "$SCRIPT"`/"$link"
+  fi
+done
+
+# Make sure that the working directory is the root dir
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+cd "${SCRIPT_DIR}/../"
+
+if [ ! -d "${APP_DIR}" ]; then
+  APP_DIR=`dirname "$SCRIPT"`/..
+  APP_DIR=`cd "${APP_DIR}"; pwd`
+fi
+
+# Make sure that we are regenerating the sample by removing any existing target directory
+TARGET_DIR="$SCRIPT_DIR/../../samples/server/petstore/graphql-server"
+if [ -d "$TARGET_DIR" ]; then
+	rm -rf $TARGET_DIR
+fi
+
+executable="$SCRIPT_DIR/../../modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+
+if [ ! -f "$executable" ]
+then
+  mvn clean package
+fi
+
+# if you've executed sbt assembly previously it will use that instead.
+export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
+ags="generate -t $SCRIPT_DIR/../../modules/openapi-generator/src/main/resources/graphql-server -i $SCRIPT_DIR/../../modules/openapi-generator/src/test/resources/3_0/petstore.yaml -g graphql-server -o $TARGET_DIR $@"
+
+java $JAVA_OPTS -jar $executable $ags

bin/openapi3/kotlin-client-petstore.sh

@@ -0,0 +1,35 @@
+#!/bin/sh
+
+SCRIPT="$0"
+echo "# START SCRIPT: $SCRIPT"
+
+while [ -h "$SCRIPT" ] ; do
+  ls=$(ls -ld "$SCRIPT")
+  link=$(expr "$ls" : '.*-> \(.*\)$')
+  if expr "$link" : '/.*' > /dev/null; then
+    SCRIPT="$link"
+  else
+    SCRIPT=$(dirname "$SCRIPT")/"$link"
+  fi
+done
+
+if [ ! -d "${APP_DIR}" ]; then
+  APP_DIR=$(dirname "$SCRIPT")/..
+  APP_DIR=$(cd "${APP_DIR}"; pwd)
+fi
+
+executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+
+if [ ! -f "$executable" ]
+then
+  mvn clean package
+fi
+
+export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
+ags="$@ generate -i modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml -t modules/openapi-generator/src/main/resources/kotlin-client -g kotlin --artifact-id kotlin-petstore-client -D dateLibrary=java8 -o samples/openapi3/client/petstore/kotlin $@"
+
+echo "Cleaning previously generated files if any from samples/openapi3/client/petstore/kotlin"
+rm -rf samples/openapi3/client/petstore/kotlin
+
+echo "Generating Kotling client..."
+java $JAVA_OPTS -jar $executable $ags

bin/openapi3/perl-petstore.sh

@@ -28,6 +28,6 @@ fi
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
 # complex module name used for testing
-ags="generate -i modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml  -g perl -o samples/client/petstore/perl -DhideGenerationTimestamp=true $@"
+ags="generate -t modules/openapi-generator/src/main/resources/perl -i modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml  -g perl -o samples/client/petstore/perl -DhideGenerationTimestamp=true $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/openapi3/ruby-client-petstore.sh

@@ -25,8 +25,13 @@ then
   mvn clean package
 fi
 
+# purge lib/doc folder
+echo "purge ruby petstore lib, docs folder"
+rm -Rf samples/openapi3/client/petstore/ruby/lib
+rm -Rf samples/openapi3/client/petstore/ruby/docs
+
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/ruby-client -i modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml -g ruby -c bin/ruby-petstore.json -o samples/client/petstore/ruby -DskipFormModel=true $@"
+ags="generate -t modules/openapi-generator/src/main/resources/ruby-client -i modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml -g ruby -c bin/ruby-petstore.json -o samples/openapi3/client/petstore/ruby -DskipFormModel=true $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/security/cpp-qt5-petstore.sh

@@ -27,6 +27,6 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/cpp-qt5-client -i modules/openapi-generator/src/test/resources/2_0/petstore-security-test.yaml -g cpp-qt5 -o samples/client/petstore-security-test/cpp-qt5 $@"
+ags="generate -t modules/openapi-generator/src/main/resources/cpp-qt5-client -i modules/openapi-generator/src/test/resources/2_0/petstore-security-test.yaml -g cpp-qt5-client -o samples/client/petstore-security-test/cpp-qt5 $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/security/perl-petstore.sh

@@ -28,7 +28,7 @@ fi
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
 # complex module name used for testing
-ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore-security-test.yaml  -l perl -o samples/client/petstore-security-test/perl $@"
+ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore-security-test.yaml -g perl -o samples/client/petstore-security-test/perl $@"
 
 java $JAVA_OPTS -jar $executable $ags
 

bin/swift3-petstore-objcCompatible.sh

@@ -27,6 +27,6 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/swift3 -i modules/openapi-generator/src/test/resources/2_0/swift/petstore-with-fake-endpoints-models-for-testing.yaml -g swift3 -c ./bin/swift3-petstore-objcCompatible.json -o samples/client/petstore/swift3/objcCompatible $@"
+ags="generate -t modules/openapi-generator/src/main/resources/swift3 -i modules/openapi-generator/src/test/resources/2_0/swift/petstore-with-fake-endpoints-models-for-testing.yaml -g swift3-deprecated -c ./bin/swift3-petstore-objcCompatible.json -o samples/client/petstore/swift3/objcCompatible $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/swift3-petstore-promisekit.sh

@@ -27,6 +27,6 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/swift3 -i modules/openapi-generator/src/test/resources/2_0/swift/petstore-with-fake-endpoints-models-for-testing.yaml -g swift3 -c ./bin/swift3-petstore-promisekit.json -o samples/client/petstore/swift3/promisekit $@"
+ags="generate -t modules/openapi-generator/src/main/resources/swift3 -i modules/openapi-generator/src/test/resources/2_0/swift/petstore-with-fake-endpoints-models-for-testing.yaml -g swift3-deprecated -c ./bin/swift3-petstore-promisekit.json -o samples/client/petstore/swift3/promisekit $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/swift3-petstore-rxswift.sh

@@ -27,6 +27,6 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/swift3 -i modules/openapi-generator/src/test/resources/2_0/swift/petstore-with-fake-endpoints-models-for-testing.yaml -g swift3 -c ./bin/swift3-petstore-rxswift.json -o samples/client/petstore/swift3/rxswift $@"
+ags="generate -t modules/openapi-generator/src/main/resources/swift3 -i modules/openapi-generator/src/test/resources/2_0/swift/petstore-with-fake-endpoints-models-for-testing.yaml -g swift3-deprecated -c ./bin/swift3-petstore-rxswift.json -o samples/client/petstore/swift3/rxswift $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/swift3-petstore-unwraprequired.sh

@@ -27,6 +27,6 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/swift3 -i modules/openapi-generator/src/test/resources/2_0/swift/petstore-with-fake-endpoints-models-for-testing.yaml -g swift3 -c ./bin/swift3-petstore-unwraprequired.json -o samples/client/petstore/swift3/unwraprequired $@"
+ags="generate -t modules/openapi-generator/src/main/resources/swift3 -i modules/openapi-generator/src/test/resources/2_0/swift/petstore-with-fake-endpoints-models-for-testing.yaml -g swift3-deprecated -c ./bin/swift3-petstore-unwraprequired.json -o samples/client/petstore/swift3/unwraprequired $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/swift3-petstore.sh

@@ -27,6 +27,6 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/swift3 -i modules/openapi-generator/src/test/resources/2_0/swift/petstore-with-fake-endpoints-models-for-testing.yaml -g swift3 -c ./bin/swift3-petstore.json -o samples/client/petstore/swift3/default $@"
+ags="generate -t modules/openapi-generator/src/main/resources/swift3 -i modules/openapi-generator/src/test/resources/2_0/swift/petstore-with-fake-endpoints-models-for-testing.yaml -g swift3-deprecated -c ./bin/swift3-petstore.json -o samples/client/petstore/swift3/default $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/typescript-angular-petstore-all.sh

@@ -9,3 +9,7 @@
 ./bin/typescript-angular-v6-petstore-not-provided-in-root-with-npm.sh
 ./bin/typescript-angular-v6-petstore-provided-in-root.sh
 ./bin/typescript-angular-v6-petstore-provided-in-root-with-npm.sh
+./bin/typescript-angular-v7-petstore-not-provided-in-root.sh
+./bin/typescript-angular-v7-petstore-not-provided-in-root-with-npm.sh
+./bin/typescript-angular-v7-petstore-provided-in-root.sh
+./bin/typescript-angular-v7-petstore-provided-in-root-with-npm.sh

bin/typescript-angular-v6-petstore-not-provided-in-root-with-npm.sh

@@ -27,6 +27,6 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -i modules/openapi-generator/src/test\resources/2_0/petstore.yaml -g typescript-angular -c bin/typescript-angular-v6-petstore-not-provided-in-root-with-npm.json -o samples/client/petstore/typescript-angular-v6-not-provided-in-root/builds/with-npm -D providedInRoot=false --additional-properties ngVersion=6.0.0 $@"
+ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g typescript-angular -c bin/typescript-angular-v6-petstore-not-provided-in-root-with-npm.json -o samples/client/petstore/typescript-angular-v6-not-provided-in-root/builds/with-npm -D providedInRoot=false --additional-properties ngVersion=6.0.0 $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/typescript-angular-v6-petstore-not-provided-in-root.sh

@@ -27,6 +27,6 @@ fi
 
 # if you've executed sbt assembly previously it will use that instead.
 export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -i modules/openapi-generator/src/test\resources/2_0/petstore.yaml -g typescript-angular -o samples/client/petstore/typescript-angular-v6-not-provided-in-root/builds/default -D providedInRoot=false --additional-properties ngVersion=6.0.0 $@"
+ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g typescript-angular -o samples/client/petstore/typescript-angular-v6-not-provided-in-root/builds/default -D providedInRoot=false --additional-properties ngVersion=6.0.0 $@"
 
 java $JAVA_OPTS -jar $executable $ags

bin/typescript-angular-v7-petstore-not-provided-in-root-with-npm.json

@@ -0,0 +1,6 @@
+{
+  "npmName": "@swagger/typescript-angular-petstore",
+  "npmVersion": "1.0.0",
+  "npmRepository" : "https://skimdb.npmjs.com/registry",
+  "snapshot" : false
+}

bin/typescript-angular-v7-petstore-not-provided-in-root-with-npm.sh

@@ -0,0 +1,32 @@
+#!/bin/sh
+
+SCRIPT="$0"
+echo "# START SCRIPT: $SCRIPT"
+
+while [ -h "$SCRIPT" ] ; do
+  ls=`ls -ld "$SCRIPT"`
+  link=`expr "$ls" : '.*-> \(.*\)$'`
+  if expr "$link" : '/.*' > /dev/null; then
+    SCRIPT="$link"
+  else
+    SCRIPT=`dirname "$SCRIPT"`/"$link"
+  fi
+done
+
+if [ ! -d "${APP_DIR}" ]; then
+  APP_DIR=`dirname "$SCRIPT"`/..
+  APP_DIR=`cd "${APP_DIR}"; pwd`
+fi
+
+executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+
+if [ ! -f "$executable" ]
+then
+  mvn -B clean package
+fi
+
+# if you've executed sbt assembly previously it will use that instead.
+export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
+ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g typescript-angular -c bin/typescript-angular-v7-petstore-not-provided-in-root-with-npm.json -o samples/client/petstore/typescript-angular-v7-not-provided-in-root/builds/with-npm -D providedInRoot=false --additional-properties ngVersion=7.0.0 $@"
+
+java $JAVA_OPTS -jar $executable $ags

bin/typescript-angular-v7-petstore-not-provided-in-root.sh

@@ -0,0 +1,32 @@
+#!/bin/sh
+
+SCRIPT="$0"
+echo "# START SCRIPT: $SCRIPT"
+
+while [ -h "$SCRIPT" ] ; do
+  ls=`ls -ld "$SCRIPT"`
+  link=`expr "$ls" : '.*-> \(.*\)$'`
+  if expr "$link" : '/.*' > /dev/null; then
+    SCRIPT="$link"
+  else
+    SCRIPT=`dirname "$SCRIPT"`/"$link"
+  fi
+done
+
+if [ ! -d "${APP_DIR}" ]; then
+  APP_DIR=`dirname "$SCRIPT"`/..
+  APP_DIR=`cd "${APP_DIR}"; pwd`
+fi
+
+executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+
+if [ ! -f "$executable" ]
+then
+  mvn -B clean package
+fi
+
+# if you've executed sbt assembly previously it will use that instead.
+export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
+ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g typescript-angular -o samples/client/petstore/typescript-angular-v7-not-provided-in-root/builds/default -D providedInRoot=false --additional-properties ngVersion=7.0.0 $@"
+
+java $JAVA_OPTS -jar $executable $ags

bin/typescript-angular-v7-petstore-provided-in-root-with-npm.json

@@ -0,0 +1,6 @@
+{
+  "npmName": "@swagger/typescript-angular-petstore",
+  "npmVersion": "1.0.0",
+  "npmRepository" : "https://skimdb.npmjs.com/registry",
+  "snapshot" : false
+}

bin/typescript-angular-v7-petstore-provided-in-root-with-npm.sh

@@ -0,0 +1,32 @@
+#!/bin/sh
+
+SCRIPT="$0"
+echo "# START SCRIPT: $SCRIPT"
+
+while [ -h "$SCRIPT" ] ; do
+  ls=`ls -ld "$SCRIPT"`
+  link=`expr "$ls" : '.*-> \(.*\)$'`
+  if expr "$link" : '/.*' > /dev/null; then
+    SCRIPT="$link"
+  else
+    SCRIPT=`dirname "$SCRIPT"`/"$link"
+  fi
+done
+
+if [ ! -d "${APP_DIR}" ]; then
+  APP_DIR=`dirname "$SCRIPT"`/..
+  APP_DIR=`cd "${APP_DIR}"; pwd`
+fi
+
+executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+
+if [ ! -f "$executable" ]
+then
+  mvn -B clean package
+fi
+
+# if you've executed sbt assembly previously it will use that instead.
+export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
+ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g typescript-angular -c bin/typescript-angular-v7-petstore-provided-in-root-with-npm.json -o samples/client/petstore/typescript-angular-v7-provided-in-root/builds/with-npm --additional-properties ngVersion=7.0.0 $@"
+
+java $JAVA_OPTS -jar $executable $ags

bin/typescript-angular-v7-petstore-provided-in-root.sh

@@ -0,0 +1,32 @@
+#!/bin/sh
+
+SCRIPT="$0"
+echo "# START SCRIPT: $SCRIPT"
+
+while [ -h "$SCRIPT" ] ; do
+  ls=`ls -ld "$SCRIPT"`
+  link=`expr "$ls" : '.*-> \(.*\)$'`
+  if expr "$link" : '/.*' > /dev/null; then
+    SCRIPT="$link"
+  else
+    SCRIPT=`dirname "$SCRIPT"`/"$link"
+  fi
+done
+
+if [ ! -d "${APP_DIR}" ]; then
+  APP_DIR=`dirname "$SCRIPT"`/..
+  APP_DIR=`cd "${APP_DIR}"; pwd`
+fi
+
+executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+
+if [ ! -f "$executable" ]
+then
+  mvn -B clean package
+fi
+
+# if you've executed sbt assembly previously it will use that instead.
+export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
+ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g typescript-angular -o samples/client/petstore/typescript-angular-v7-provided-in-root/builds/default --additional-properties ngVersion=7.0.0 $@"
+
+java $JAVA_OPTS -jar $executable $ags

bin/typescript-fetch-petstore-target-es6.sh

@@ -30,3 +30,5 @@ export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/
 ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g typescript-fetch -c bin/typescript-fetch-petstore-target-es6.json -o samples/client/petstore/typescript-fetch/builds/es6-target $@"
 
 java $JAVA_OPTS -jar $executable $ags
+cp CI/samples.ci/client/petstore/typescript-fetch/builds/es6-target/pom.xml samples/client/petstore/typescript-fetch/builds/es6-target/pom.xml
+cp CI/samples.ci/client/petstore/typescript-fetch/tests/default/pom.xml samples/client/petstore/typescript-fetch/tests/default/pom.xml 

bin/typescript-fetch-petstore-with-npm-version.sh

@@ -30,3 +30,5 @@ export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/
 ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g typescript-fetch -c bin/typescript-fetch-petstore-with-npm-version.json -o samples/client/petstore/typescript-fetch/builds/with-npm-version $@"
 
 java $JAVA_OPTS -jar $executable $ags
+cp CI/samples.ci/client/petstore/typescript-fetch/builds/with-npm-version/pom.xml samples/client/petstore/typescript-fetch/builds/with-npm-version/pom.xml
+cp CI/samples.ci/client/petstore/typescript-fetch/tests/default/pom.xml samples/client/petstore/typescript-fetch/tests/default/pom.xml 

bin/typescript-fetch-petstore.sh

@@ -30,3 +30,5 @@ export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/
 ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g typescript-fetch -o samples/client/petstore/typescript-fetch/builds/default $@"
 
 java $JAVA_OPTS -jar $executable $ags
+cp CI/samples.ci/client/petstore/typescript-fetch/builds/default/pom.xml samples/client/petstore/typescript-fetch/builds/default/pom.xml
+cp CI/samples.ci/client/petstore/typescript-fetch/tests/default/pom.xml samples/client/petstore/typescript-fetch/tests/default/pom.xml 

bin/utils/copy-to-website.sh

@@ -0,0 +1,34 @@
+#!/bin/sh
+
+SCRIPT="$0"
+echo "# START SCRIPT: $SCRIPT"
+
+conduct_in=CODE_OF_CONDUCT.md
+contrib_in=CONTRIBUTING.md
+conduct_out=docs/conduct.md
+contrib_out=docs/contributing.md
+
+
+\rm -rf "${conduct_out}"
+\rm -rf "${contrib_out}"
+
+cat > "${conduct_out}" << EOF
+---
+id: code-of-conduct
+title: Code of Conduct
+---
+
+$(tail -n +3 "${conduct_in}")
+EOF
+echo "Wrote $(pwd)/${conduct_out}"
+
+cat > "${contrib_out}" << EOF
+---
+id: contributing
+title: Guidelines For Contributing
+sidebar_label: Guidelines
+---
+
+$(tail -n +3 "${contrib_in}")
+EOF
+echo "Wrote $(pwd)/${contrib_out}"

bin/utils/ensure-up-to-date

@@ -11,6 +11,7 @@ sleep 5
 
 # LIST OF SCRIPTS:
 declare -a scripts=("./bin/openapi3/ruby-client-petstore.sh"
+"./bin/ruby-client-petstore.sh"
 "./bin/java-petstore-all.sh"
 "./bin/java-jaxrs-petstore-server-all.sh"
 "./bin/openapi3/jaxrs-jersey-petstore.sh"
@@ -36,6 +37,9 @@ declare -a scripts=("./bin/openapi3/ruby-client-petstore.sh"
 "./bin/csharp-petstore.sh"
 "./bin/meta-codegen.sh"
 "./bin/utils/export_docs_generators.sh"
+"./bin/utils/export_generators_docusaurus_index.sh"
+"./bin/utils/copy-to-website.sh"
+"./bin/utils/export_generators_readme.sh"
 "./bin/go-petstore.sh"
 "./bin/go-gin-petstore-server.sh")
 

bin/utils/export_generator.sh

@@ -14,6 +14,4 @@ fi
 
 executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
 
-java -jar ${executable} config-help -g ${NAME} --named-header -o docs/generators/${NAME}.md
-
-echo "Back to the [generators list](README.md)" >> docs/generators/${NAME}.md
+java -jar ${executable} config-help -g ${NAME} --named-header --format markdown --markdown-header -o docs/generators/${NAME}.md

bin/utils/export_generators_docusaurus_index.sh

@@ -0,0 +1,20 @@
+#!/bin/sh
+
+SCRIPT="$0"
+echo "# START SCRIPT: $SCRIPT"
+
+executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+
+\rm -rf docs/generators.md
+
+cat > docs/generators.md << EOF
+---
+id: generators
+title: Generators List
+---
+
+EOF
+
+java -jar $executable list --docsite >> docs/generators.md
+
+echo "Wrote $(pwd)/docs/generators.md"

bin/utils/export_generators_readme.sh

@@ -5,4 +5,16 @@ echo "# START SCRIPT: $SCRIPT"
 
 executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
 
-java -jar $executable list | sed -e 's/\([A-Z]*\) generators:/* \1 generators:/g' -e 's/- \([a-z0-9\-]*\)/- [\1]\(\1.md\)/g' > docs/generators/README.md
+\rm -rf docs/generators.md
+
+cat > docs/generators.md << EOF
+---
+id: generators
+title: Generators List
+---
+
+EOF
+
+java -jar $executable list | sed -e 's/\([A-Z]*\) generators:/* \1 generators:/g' -e 's/- \([a-z0-9\-]*\)/- [\1]\(generators\/\1.md\)/g' >> docs/generators.md
+
+echo "Wrote $(pwd)/docs/generators.md"

bin/utils/release_checkout.rb

@@ -1,8 +1,26 @@
-#release_chekcout.rb
+#!/usr/bin/env ruby
+#
+# release_chekcout.rb
+#
 require 'rubygems'
 require 'open-uri'
 require 'net/http'
 
+def check_npmjs
+  print "Checking npmjs... "
+
+  url = "https://www.npmjs.com/package/@openapitools/openapi-generator-cli?activeTab=versions"
+  open(url) do |f|
+    content = f.read
+    if !content.nil? && content.include?($version)
+      puts "[OK]"
+    else
+      puts "[ERROR]"
+      puts "> #{url} not yet updated with #{$version}"
+    end
+  end
+end
+
 def check_homebrew
   print "Checking homebrew forumla ... "
 
@@ -184,6 +202,7 @@ $version = ARGV[0]
 
 puts "Running checkout on OpenAPI Generator release #{$version}"
 
+check_npmjs
 check_homebrew
 check_openapi_generator_jar
 check_openapi_generator_cli_jar

bin/windows/c-petstore.bat

@@ -0,0 +1,10 @@
+set executable=.\modules\openapi-generator-cli\target\openapi-generator-cli.jar
+
+If Not Exist %executable% (
+  mvn clean package
+)
+
+REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g c -o samples\client\petstore\c
+
+java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/cpp-qt5-petstore.bat

@@ -5,6 +5,6 @@ If Not Exist %executable% (
 )
 
 REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M
-set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g cpp-qt5 -o samples\client\petstore\cpp-qt5
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g cpp-qt5-client -o samples\client\petstore\cpp-qt5
 
 java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/dart-client-petstore.bat

@@ -5,8 +5,8 @@ If Not Exist %executable% (
 )
 
 REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M -DloggerPath=conf/log4j.properties
-set ags=generate -i modules\swagger-codegen\src\test\resources\2_0\petstore.yaml -l dart-jaguar -o samples\client\petstore\dart-jaguar\swagger -DhideGenerationTimestamp=true -DbrowserClient=false
+set ags=generate -i modules\swagger-codegen\src\test\resources\2_0\petstore.yaml -g dart-jaguar -o samples\client\petstore\dart-jaguar\swagger -DhideGenerationTimestamp=true -DbrowserClient=false
 java %JAVA_OPTS% -jar %executable% %ags%
 
-set ags=generate -i modules\swagger-codegen\src\test\resources\2_0\petstore.yaml -l dart-jaguar -o samples\client\petstore\dart-jaguar\flutter_petstore\swagger -DhideGenerationTimestamp=true
+set ags=generate -i modules\swagger-codegen\src\test\resources\2_0\petstore.yaml -g dart-jaguar -o samples\client\petstore\dart-jaguar\flutter_petstore\swagger -DhideGenerationTimestamp=true
 java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/graphql-petstore-server.bat

@@ -0,0 +1,10 @@
+set executable=.\modules\openapi-generator-cli\target\openapi-generator-cli.jar
+
+If Not Exist %executable% (
+  mvn clean package
+)
+
+REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M
+set ags=generate -t modules\openapi-generator\src\main\resources\graphql-server -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g graphql-server -o samples\server\petstore\graphql-server
+
+java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/graphql-schema-petstore.bat

@@ -0,0 +1,10 @@
+set executable=.\modules\openapi-generator-cli\target\openapi-generator-cli.jar
+
+If Not Exist %executable% (
+  mvn clean package
+)
+
+REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M
+set ags=generate -t modules\openapi-generator\src\main\resources\graphql-schema -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g graphql-schema -o samples\config\petstore\graphql-schema
+
+java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/swift3-petstore-promisekit.bat

@@ -5,6 +5,6 @@ If Not Exist %executable% (
 )
 
 REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M
-set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore-with-fake-endpoints-models-for-testing.yaml -g swift3 -c bin\swift3-petstore-promisekit.json -o samples\client\petstore\swift3\promisekit
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore-with-fake-endpoints-models-for-testing.yaml -g swift3-deprecated -c bin\swift3-petstore-promisekit.json -o samples\client\petstore\swift3\promisekit
 
 java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/swift3-petstore-rxswift.bat

@@ -5,6 +5,6 @@ If Not Exist %executable% (
 )
 
 REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M
-set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore-with-fake-endpoints-models-for-testing.yaml -g swift3 -c bin\swift3-petstore-rxswift.json -o samples\client\petstore\swift3\rxswift
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore-with-fake-endpoints-models-for-testing.yaml -g swift3-deprecated -c bin\swift3-petstore-rxswift.json -o samples\client\petstore\swift3\rxswift
 
 java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/swift3-petstore.bat

@@ -5,6 +5,6 @@ If Not Exist %executable% (
 )
 
 REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M
-set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore-with-fake-endpoints-models-for-testing.yaml -g swift3 -o samples\client\petstore\swift3\default
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore-with-fake-endpoints-models-for-testing.yaml -g swift3-deprecated -o samples\client\petstore\swift3\default
 
 java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/typescript-angular-petstore-all.bat

@@ -7,5 +7,8 @@ call .\bin\windows\typescript-angular-v6-provided-in-root.bat
 call .\bin\windows\typescript-angular-v6-provided-in-root-with-npm.bat
 call .\bin\windows\typescript-angular-v6-not-provided-in-root.bat
 call .\bin\windows\typescript-angular-v6-not-provided-in-root-with-npm.bat
-
+call .\bin\windows\typescript-angular-v7-provided-in-root.bat
+call .\bin\windows\typescript-angular-v7-provided-in-root-with-npm.bat
+call .\bin\windows\typescript-angular-v7-not-provided-in-root.bat
+call .\bin\windows\typescript-angular-v7-not-provided-in-root-with-npm.bat
 

bin/windows/typescript-angular-v6-not-provided-in-root-with-npm.bat

@@ -5,6 +5,6 @@ If Not Exist %executable% (
 )
 
 REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M
-set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -l typescript-angular -c bin\typescript-angular-v6-petstore-not-provided-in-root-with-npm.json -o samples\client\petstore\typescript-angular-v6-not-provided-in-root\builds\with-npm -D providedInRoot=false --additional-properties ngVersion=6.0.0
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g typescript-angular -c bin\typescript-angular-v6-petstore-not-provided-in-root-with-npm.json -o samples\client\petstore\typescript-angular-v6-not-provided-in-root\builds\with-npm -D providedInRoot=false --additional-properties ngVersion=6.0.0
 
 java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/typescript-angular-v6-not-provided-in-root.bat

@@ -5,6 +5,6 @@ If Not Exist %executable% (
 )
 
 REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M
-set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -l typescript-angular -o samples\client\petstore\typescript-angular-v6-not-provided-in-root\builds\default -D providedInRoot=false --additional-properties ngVersion=6.0.0
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g typescript-angular -o samples\client\petstore\typescript-angular-v6-not-provided-in-root\builds\default -D providedInRoot=false --additional-properties ngVersion=6.0.0
 
 java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/typescript-angular-v6-provided-in-root-with-npm.bat

@@ -4,6 +4,6 @@ If Not Exist %executable% (
   mvn clean package
 )
 
-set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -l typescript-angular -c bin/typescript-angular-v6-petstore-provided-in-root-with-npm.json -o samples\client\petstore\typescript-angular-v6-provided-in-root\builds\with-npm --additional-properties ngVersion=6.0.0
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g typescript-angular -c bin/typescript-angular-v6-petstore-provided-in-root-with-npm.json -o samples\client\petstore\typescript-angular-v6-provided-in-root\builds\with-npm --additional-properties ngVersion=6.0.0
 
 java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/typescript-angular-v6-provided-in-root.bat

@@ -4,6 +4,6 @@ If Not Exist %executable% (
   mvn clean package
 )
 
-set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -l typescript-angular -o samples\client\petstore\typescript-angular-v6-provided-in-root\builds\default --additional-properties ngVersion=6.0.0
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g typescript-angular -o samples\client\petstore\typescript-angular-v6-provided-in-root\builds\default --additional-properties ngVersion=6.0.0
 
 java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/typescript-angular-v7-not-provided-in-root-with-npm.bat

@@ -0,0 +1,10 @@
+set executable=.\modules\openapi-generator-cli\target\openapi-generator-cli.jar
+
+If Not Exist %executable% (
+  mvn clean package
+)
+
+REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g typescript-angular -c bin\typescript-angular-v7-petstore-not-provided-in-root-with-npm.json -o samples\client\petstore\typescript-angular-v7-not-provided-in-root\builds\with-npm -D providedInRoot=false --additional-properties ngVersion=7.0.0
+
+java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/typescript-angular-v7-not-provided-in-root.bat

@@ -0,0 +1,10 @@
+set executable=.\modules\openapi-generator-cli\target\openapi-generator-cli.jar
+
+If Not Exist %executable% (
+  mvn clean package
+)
+
+REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g typescript-angular -o samples\client\petstore\typescript-angular-v7-not-provided-in-root\builds\default -D providedInRoot=false --additional-properties ngVersion=7.0.0
+
+java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/typescript-angular-v7-provided-in-root-with-npm.bat

@@ -0,0 +1,9 @@
+set executable=.\modules\openapi-generator-cli\target\openapi-generator-cli.jar
+
+If Not Exist %executable% (
+  mvn clean package
+)
+
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g typescript-angular -c bin/typescript-angular-v7-petstore-provided-in-root-with-npm.json -o samples\client\petstore\typescript-angular-v7-provided-in-root\builds\with-npm --additional-properties ngVersion=7.0.0
+
+java %JAVA_OPTS% -jar %executable% %ags%

bin/windows/typescript-angular-v7-provided-in-root.bat

@@ -0,0 +1,9 @@
+set executable=.\modules\openapi-generator-cli\target\openapi-generator-cli.jar
+
+If Not Exist %executable% (
+  mvn clean package
+)
+
+set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g typescript-angular -o samples\client\petstore\typescript-angular-v7-provided-in-root\builds\default --additional-properties ngVersion=7.0.0
+
+java %JAVA_OPTS% -jar %executable% %ags%

docker-compose.yml

@@ -0,0 +1,18 @@
+version: "3"
+
+services:
+  docusaurus:
+    build: .
+    ports:
+      - 3000:3000
+      - 35729:35729
+    volumes:
+      - ./docs:/app/docs
+      - ./website/blog:/app/website/blog
+      - ./website/core:/app/website/core
+      - ./website/i18n:/app/website/i18n
+      - ./website/pages:/app/website/pages
+      - ./website/static:/app/website/static
+      - ./website/sidebars.json:/app/website/sidebars.json
+      - ./website/siteConfig.js:/app/website/siteConfig.js
+    working_dir: /app/website

docs/3.0.0-release-note.md

@@ -1,361 +1,362 @@
-## Docker
-7dfd94002 Docker: use correct MAVEN_CONFIG (#182)
-b5a0d173d Revise the usage of OpenAPI Generator online (docker image) (#73)
-e58dc2c77 Fix COPY in Dockerfile (#64)
-9d7feaaeb Fix online generator (docker push) (#58)
-9247cd01e Changes for Docker
-64037ee59 update docker-related files to ues jdk8
+---
+id: release-3-0-0
+title: Release Notes: 3.0.0
+sidebar_label: Release Notes: 3.0.0
+---
 
-## Plug-ins
-b6b8c0db8 [gradle-plugin] Initial implementation (#162) 
-0a28aad73 [MAVEN PLUGIN] Checking for null configOptions before looking for property
-9c79297d6 [MAVEN PLUGIN] Use latest version in dependencies snippet
-9e1bbe0c1 Add maven wrapper
+* ## Docker
+* 7dfd94002 Docker: use correct MAVEN_CONFIG (#182)
+* b5a0d173d Revise the usage of OpenAPI Generator online (docker image) (#73)
+* e58dc2c77 Fix COPY in Dockerfile (#64)
+* 9d7feaaeb Fix online generator (docker push) (#58)
+* 9247cd01e Changes for Docker
+* 64037ee59 update docker-related files to ues jdk8
+ 
+* ## Plug-ins
+* b6b8c0db8 \[gradle-plugin] Initial implementation (#162)  
+* 0a28aad73 \[MAVEN PLUGIN] Checking for null configOptions before looking for property
+* 9c79297d6 \[MAVEN PLUGIN] Use latest version in dependencies snippet
+* 9e1bbe0c1 Add maven wrapper
+ 
+* ## API Clients
+* ### Ada
+* edf6be8c0 \[Ada] bug fix by defining x-is-model-type when property is local to the YML file
+* 9ba74f484 \[Ada] Fix GNAT project and server skeleton to avoid sending a response when an error is returned
+* ea27924f5 \[Ada] changed default project/package name, to solve circular dependencies
+* 6b9d38d40 remove trailing spaces in ada template
+* 0de7f972f Fix the Ada server skeleton to check the authsMethods in the Shared_Instance generic package
+* 4bd8fc6e8 Fix 7511: \[Ada] Client call is not correct with multiple parameters and application/x-www-urlencoded
+* 3035bc629 \[Ada] Hotfix/ada model sort
+* 43f0e8692 Ada code generator corrected: "=>" instead of "->".  
+* 7d2b49085 \[Ada] wrong order for generated structures in models.ads files
+* 2b2b85eec \[Ada] wrong JSON in POST operations
 
-## API Clients
-### Ada
-edf6be8c0 [Ada] bug fix by defining x-is-model-type when property is local to the YML file
-9ba74f484 [Ada] Fix GNAT project and server skeleton to avoid sending a response when an error is returned
-ea27924f5 [Ada] changed default project/package name, to solve circular dependencies
-6b9d38d40 remove trailing spaces in ada template
-0de7f972f Fix the Ada server skeleton to check the authsMethods in the Shared_Instance generic package
-4bd8fc6e8 Fix 7511: [Ada] Client call is not correct with multiple parameters and application/x-www-urlencoded
-3035bc629 [Ada] Hotfix/ada model sort
-43f0e8692 Ada code generator corrected: "=>" instead of "->". 
-7d2b49085 [Ada] wrong order for generated structures in models.ads files
-2b2b85eec [Ada] wrong JSON in POST operations
+* ### C#
+* 0e34bcf4e \[csharp] ctor params should always be camelCase
+* 872471996 \[csharp] Support arrays of arrays for properties and models
+* 1c4e6b7d4 \[csharp] Fix ToJson to work with composition and polymorphism
+* ed7af73f6 \[csharp] Reference this.Configuration in client API template
 
-### C#
-0e34bcf4e [csharp] ctor params should always be camelCase
-872471996 [csharp] Support arrays of arrays for properties and models
-1c4e6b7d4 [csharp] Fix ToJson to work with composition and polymorphism
-ed7af73f6 [csharp] Reference this.Configuration in client API template
+* ### C++
+* e796e4c36 \[C++] Add linux as a reserve keyword
+* 36f69a034 remove trailing spaces in qt5 c++ templates
+* f192613f1 fix string type in c++ generator
+* 409015461 fix file type in qt5cpp
+* a4bcb3bc7 fix datetime and map type for qt5cpp
+* 23b31aba8 \[qt5cpp] Fix crash when API return a map container
+* 3b031ed2b \[qt5cpp] delete callback data allocated before signal emission
+* 1bb1e44d1 \[qt5cpp] Remove qt5 pro.user file
+* 194722015 Qt5cpp plug memleaks part2
+* 12f3661d6 Qt5cpp plug memleaks
+* ea4b94842 \[qt5cpp] Add nullptr guard to prevent crash when empty model is being serialized
+* 0bf430a80 Qt5cpp Add support for nested containers
+* 0b3ec6b1f fix NPE with cpp qt5, add logic to avoid NPE with composed schema
+* 7c734445b fix file parameter in header file (cpprest)
+* 070b5c00b fix object type declaration in cpprest
+* bad1885b4 \[cpprest] add parameterToString for number type with unspecified format (double)
+* 73bd24db7 \[cpprest] Add support for nested vectors
+* ee2eb74f7 \[qt] update Qt client
+* d82499944 Adding qt project generation fix
+* 9bd94b4db \[qt] Fix warning message
 
-### C++
-e796e4c36 [C++] Add linux as a reserve keyword
-36f69a034 remove trailing spaces in qt5 c++ templates
-f192613f1 fix string type in c++ generator
-409015461 fix file type in qt5cpp
-a4bcb3bc7 fix datetime and map type for qt5cpp
-23b31aba8 [qt5cpp] Fix crash when API return a map container
-3b031ed2b [qt5cpp] delete callback data allocated before signal emission
-1bb1e44d1 [qt5cpp] Remove qt5 pro.user file
-194722015 Qt5cpp plug memleaks part2
-12f3661d6 Qt5cpp plug memleaks
-ea4b94842 [qt5cpp] Add nullptr guard to prevent crash when empty model is being serialized
-0bf430a80 Qt5cpp Add support for nested containers
-0b3ec6b1f fix NPE with cpp qt5, add logic to avoid NPE with composed schema
-7c734445b fix file parameter in header file (cpprest)
-070b5c00b fix object type declaration in cpprest
-bad1885b4 [cpprest] add parameterToString for number type with unspecified format (double)
-73bd24db7 [cpprest] Add support for nested vectors
-ee2eb74f7 [qt] update Qt client
-d82499944 Adding qt project generation fix
-9bd94b4db [qt] Fix warning message
+* ### Clojure
+* d7e374504 \[Clojure] Add util method to set the api-context globally (#93)
 
-### Clojure
-d7e374504 [Clojure] Add util method to set the api-context globally (#93)
+* ### Dart
+* f1638a659 \[Dart] Allow setting an accessToken for OAuth
+* a5e26a44f \[Dart] - Rework Dart client generator to be flutter-compatible
 
-### Dart
-f1638a659 [Dart] Allow setting an accessToken for OAuth
-a5e26a44f [Dart] - Rework Dart client generator to be flutter-compatible
+* ### Elixir
+* f9b2839a3 \[Elixir] Check date value before calling to_iso8601
 
-### Elixir
-f9b2839a3 [Elixir] Check date value before calling to_iso8601
+* ### Elm
+* 5a87fe695 \[elm] Fix operations with empty responses (#171)
+* a5cf27b60 Fix Petstore example for Elm (#96)
+* c522927d5 Fix Elm generator for polymorphism (#78)
+* 7d9fb9f51 Add CI test for Elm in travis (#40)
+* 769a65c95 \[Elm] Add support for array schemas
+* 56a0268e3 \[elm] missing '->' in Main elm template
 
-### Elm
-5a87fe695 [elm] Fix operations with empty responses (#171)
-a5cf27b60 Fix Petstore example for Elm (#96)
-c522927d5 Fix Elm generator for polymorphism (#78)
-7d9fb9f51 Add CI test for Elm in travis (#40)
-769a65c95 [Elm] Add support for array schemas
-56a0268e3 [elm] missing '->' in Main elm template
+* ### Erlang
+* c73118524 \[erlang-client] Erlang request utils
+* 049eef9c5 Test erlang client, server petstore
+* bcc7b788e fix erlang client compilation error
 
-### Erlang
-c73118524 [erlang-client] Erlang request utils
-049eef9c5 Test erlang client, server petstore
-bcc7b788e fix erlang client compilation error
+* ### Go
+* acb63fd5e Fix go readme, remove resty install
+* 5d8362d85 Update go client, fix double body read
+* 47614bb76 Properly capitalize exported go types
+* ee561fcd6 Add withXml option for Go language
+* 0f6696089 \[Go] Use consistent indentation in readme  
+* 72abb20f2 \[Go] Fix operation files clobbering model files. \[2.4.0]
 
-### Go
-acb63fd5e Fix go readme, remove resty install
-5d8362d85 Update go client, fix double body read
-47614bb76 Properly capitalize exported go types
-ee561fcd6 Add withXml option for Go language
-0f6696089 [Go] Use consistent indentation in readme 
-72abb20f2 [Go] Fix operation files clobbering model files. [2.4.0]
+* ### Haskell
+* 34db79b9b \[haskell-http-client] update dependency versions + readme (#81)
+* e45b3784f Fix NPE with Haskell client generator with OAS3 spec
+* d3401396f \[haskell-http-client] remove duplicates in produces/consumes; fix pathParam paramName issue
+* 4bc99b9da minor fixes to haskell http client generator
+* 2d0bafb6b \[haskell-http-client] default InlineMimeTypes=true
+* 9fba9c325 \[haskell-http-client] add config options: cabalPackage, cabalVersion, baseModule, requestType, configType
 
-### Haskell
-34db79b9b [haskell-http-client] update dependency versions + readme (#81)
-e45b3784f Fix NPE with Haskell client generator with OAS3 spec
-d3401396f [haskell-http-client] remove duplicates in produces/consumes; fix pathParam paramName issue
-4bc99b9da minor fixes to haskell http client generator
-2d0bafb6b [haskell-http-client] default InlineMimeTypes=true
-9fba9c325 [haskell-http-client] add config options: cabalPackage, cabalVersion, baseModule, requestType, configType
+* ### Kotlin
+* a3322fbf7 \[kotlin] Add OkHttpClient.Builder to ApiClient.
+* 3c5fb1d80 \[kotlin] Add json annotation to each enum value.
+* 39fa375e3 \[kotlin] Fix NPE for POST/PUT/PATCH with empty request models.
+* c599906f1 Kotlin: Correct data_class.mustache to use proper property for inner enum data type
+* c69925b53 \[Kotlin] Fix issues with threetenbp  
+* a811a48c3 minor fix to kotlin client genrator due to merge conflict
+* 914275fe7 \[kotlin] support selection of datelibrary
+* a61d23265 Fixed incorrect renaming of header and query param to camel cases for Kotlin Client template
 
-### Kotlin
-a3322fbf7 [kotlin] Add OkHttpClient.Builder to ApiClient.
-3c5fb1d80 [kotlin] Add json annotation to each enum value.
-39fa375e3 [kotlin] Fix NPE for POST/PUT/PATCH with empty request models.
-c599906f1 Kotlin: Correct data_class.mustache to use proper property for inner enum data type
-c69925b53 [Kotlin] Fix issues with threetenbp 
-a811a48c3 minor fix to kotlin client genrator due to merge conflict
-914275fe7 [kotlin] support selection of datelibrary
-a61d23265 Fixed incorrect renaming of header and query param to camel cases for Kotlin Client template
+* ### Lua
+* dbe78e23e \[Lua] Improve auto-generated test files
+* 6c79052ac Add auto-generated Lua spec files for APIs, models
+* 38a2c1dde \[Lua] Fix Rockpec
+* a2410b210 Add auto-generated rockspec file to Lua API client
+* df10c725a Add lua test script, minor fix to Lua API files
 
-### Lua
-dbe78e23e [Lua] Improve auto-generated test files
-6c79052ac Add auto-generated Lua spec files for APIs, models
-38a2c1dde [Lua] Fix Rockpec
-a2410b210 Add auto-generated rockspec file to Lua API client
-df10c725a Add lua test script, minor fix to Lua API files
+* ### Java
+* 2e69e6c03 build.gradle should not have commas
+* 1a4e5a4e5 Java client: Add constants for libraries (#163)
+* 7db0201a8 Fix NPEs in Java generator (#154)
+* 4d7ff8cfb JavaDoc fixes for Java/RESTEasy client (#151)
+* 072ce070b resteasy: fix outer enum case (#139)
+* ccd002966 \[Java] rest-assured: fix javadoc in templates
+* e7410d4c8 Allow $ in java var name
+* 03490e923 Fix Java binary mapping
+* 70b4b55fa Fix performance linting problem with maps in Java ApiClient template
+* cddcda0fe \[Java][Jersey2] Make generated client code thread safe
+* 298ca8d35 use correct jackson date library when using Java 8
+* 53eeb0c04 \[Java] fix connection leak on retrofit OAuth token renewal
+* 61c25e711 \[Java] Fixes for retrofit
+* f02332755 \[JAVA] 4709: codegen with parcelableMode fails to build if using arrays in swagger.
+* 4eeb974cb \[Java][google-api-client] Fix bug with empty POST request not sending content-type
+* d4543a99e \[Java][retrofit2] file upload sets filename as baseName instead of a dynamic filename
+* 62a930223 \[JAVA][Rest-assured] reqSpec() method has been added into api.mustache for requests custom…
+* fec0363f7 \[Java] Add back byte array enhancement
+* 59ff4c198 \[Java][library: vertx] Add default value and required parameter support to vertx server temp…
+* 3bd2da9a8 \[Java] Fix build warnings
+* 429b96ae7 \[JAVA] equals and hashCode for models with byte[] and binary strings
+* 495971c2c \[Java] use html entities in javadoc of generated code (#106)
+* 82ee8656f \[java] Enum in array of array (#66)
+* bf7e4e7df Java gson: add @SerializedName value as constant  (#22)
+* 30c1448d7 Fix build.gradle for Java RESTEasy client
+* 642c0566d \[Java] Use Rx2 Completalbe for Void Retrofit2 responses
+* 72221b1cf Adding @Deprecated to retrofit2 client interfaces.
+* 47111b324 \[Java] fix gson deserialize format byte
+* 9e06f7063 \[Java] Fix assignment of new object instance to variable
+* 006f084b5 \[Java] Allow to set values with setApiPackage(..) and setModelPackage(..)
 
-### Java
-2e69e6c03 build.gradle should not have commas
-1a4e5a4e5 Java client: Add constants for libraries (#163)
-7db0201a8 Fix NPEs in Java generator (#154)
-4d7ff8cfb JavaDoc fixes for Java/RESTEasy client (#151)
-072ce070b resteasy: fix outer enum case (#139)
-ccd002966 [Java] rest-assured: fix javadoc in templates
-e7410d4c8 Allow $ in java var name
-03490e923 Fix Java binary mapping
-70b4b55fa Fix performance linting problem with maps in Java ApiClient template
-cddcda0fe [Java][Jersey2] Make generated client code thread safe
-298ca8d35 use correct jackson date library when using Java 8
-53eeb0c04 [Java] fix connection leak on retrofit OAuth token renewal
-61c25e711 [Java] Fixes for retrofit
-f02332755 [JAVA] 4709: codegen with parcelableMode fails to build if using arrays in swagger.
-4eeb974cb [Java][google-api-client] Fix bug with empty POST request not sending content-type
-d4543a99e [Java][retrofit2] file upload sets filename as baseName instead of a dynamic filename
-62a930223 [JAVA][Rest-assured] reqSpec() method has been added into api.mustache for requests custom…
-fec0363f7 [Java] Add back byte array enhancement
-59ff4c198 [Java][library: vertx] Add default value and required parameter support to vertx server temp…
-3bd2da9a8 [Java] Fix build warnings
-429b96ae7 [JAVA] equals and hashCode for models with byte[] and binary strings
-495971c2c [Java] use html entities in javadoc of generated code (#106)
-82ee8656f [java] Enum in array of array (#66)
-bf7e4e7df Java gson: add @SerializedName value as constant  (#22)
-30c1448d7 Fix build.gradle for Java RESTEasy client
-642c0566d [Java] Use Rx2 Completalbe for Void Retrofit2 responses
-72221b1cf Adding @Deprecated to retrofit2 client interfaces.
-47111b324 [Java] fix gson deserialize format byte
-9e06f7063 [Java] Fix assignment of new object instance to variable
-006f084b5 [Java] Allow to set values with setApiPackage(..) and setModelPackage(..)
+* ### JavaScript/NodeJS
+* d80e29585 Fix JS test using baseName in default value (#5)
+* fe15f4690 fix toDefaultValueWithParam in JS
+* 90859575e Fixing variable name typo (instane -> instance)
 
-### JavaScript/NodeJS
-d80e29585 Fix JS test using baseName in default value (#5)
-fe15f4690 fix toDefaultValueWithParam in JS
-90859575e Fixing variable name typo (instane -> instance)
+* ### Objective-C
+* 9fb2c29a4 7644 objc deprecated afnetworking datataskwithrequest
+* 5d1874028 add class as a keyword in objc generator
+* 1b8df5c20 Update ObjcClientCodegen.java
+* 246ed5754 restore objc reserved word: property
 
-### Objective-C
-9fb2c29a4 7644 objc deprecated afnetworking datataskwithrequest
-5d1874028 add class as a keyword in objc generator
-1b8df5c20 Update ObjcClientCodegen.java
-246ed5754 restore objc reserved word: property
+* ### PHP
+* 3beeb4e77 \[PHP] Not-required properties now shows as nullable (#129)
+* 37df59d6f \[PHP] Adjust the names (script, sample folder, generator) to lang option (#159)
+* 4a5d16b23 \[PHP] Fix string length validation
+* d58835e57 \[PHP] Improve: Make validation strict
+* cf8d8d56f \[PHP] Fix code example from README. Variable name was missing when using Basic auth.
+* 0adbf7e51 \[PHP] Improve: update sample tests automatically
+* 32cf2f16f \[PHP] Non required enum property
+* 3bcf0ff76 \[PHP] Add path & file separator (/) to return the correct path when deserializing a file
+* 14e1e1980 \[PHP] Improve validation on empty arrays
+* 809e1f4c9 \[PHP] Cleanup tests
+* 76907cacd \[PHP] declare property headerSelector
 
-### PHP
-3beeb4e77 [PHP] Not-required properties now shows as nullable (#129)
-37df59d6f [PHP] Adjust the names (script, sample folder, generator) to lang option (#159)
-4a5d16b23 [PHP] Fix string length validation
-d58835e57 [PHP] Improve: Make validation strict
-cf8d8d56f [PHP] Fix code example from README. Variable name was missing when using Basic auth.
-0adbf7e51 [PHP] Improve: update sample tests automatically
-32cf2f16f [PHP] Non required enum property
-3bcf0ff76 [PHP] Add path & file separator (/) to return the correct path when deserializing a file
-14e1e1980 [PHP] Improve validation on empty arrays
-809e1f4c9 [PHP] Cleanup tests
-76907cacd [PHP] declare property headerSelector
+* ### Python
+* 7184f1ec6 \[python] asyncio supports _preload_content; remove unused imports (#107)
+* d74d2ba03 fix: python clients
+* 8e0a0ebd6 Fix python / tornado body handling
+* b39c35c76 Fix inconsistency between model name and file name in python client
+* dfbef4374 Fixed unicode error and supported allow_nonstandard_methods in tornado based python client
+* f6e0e297e \[python-asyncio] tests and fixes
 
-### Python
-7184f1ec6 [python] asyncio supports _preload_content; remove unused imports (#107)
-d74d2ba03 fix: python clients
-8e0a0ebd6 Fix python / tornado body handling
-b39c35c76 Fix inconsistency between model name and file name in python client
-dfbef4374 Fixed unicode error and supported allow_nonstandard_methods in tornado based python client
-f6e0e297e [python-asyncio] tests and fixes
+* ### R
+* 61e58d649 Add R namespace file
 
-### R
-61e58d649 Add R namespace file
+* ### Ruby
+* a08164592 fix ruby parameters in documentation, fix reuqiredParams, optionalParams
+* 8e34f9a98 update to newer version of ruby
+* aa6b217bb \[Ruby] Add auto-generated rubocop config file
 
-### Ruby
-a08164592 fix ruby parameters in documentation, fix reuqiredParams, optionalParams
-8e34f9a98 update to newer version of ruby
-aa6b217bb [Ruby] Add auto-generated rubocop config file
+* ### Rust
+* b44357394 \[Rust] Implement minimal auth support
+* 0b845a57e \[Rust] Changes hard coded body to dynamic parameter name -  
+* a3c97753f \[Rust] Handles UUID as string
+* 027df610b \[Rust] Handle error response statuses
+* 66be7a791 \[Rust] Add user agent handling for rust template (master)  
+* 3029b7b0f \[Rust] Format example with rustfmt
 
-### Rust
-b44357394 [Rust] Implement minimal auth support
-0b845a57e [Rust] Changes hard coded body to dynamic parameter name - 
-a3c97753f [Rust] Handles UUID as string
-027df610b [Rust] Handle error response statuses
-66be7a791 [Rust] Add user agent handling for rust template (master) 
-3029b7b0f [Rust] Format example with rustfmt
-
-### Scala
-197b4481e normalize akka-scala and Java README
-612cfb7af [Akka-scala] Clean unused dependencies such swagger-core
-86697fedb [Scala][Gatling] correct body params filename
-832919b84 [Scala][Akka] Remove unused dep when model package is empty
-
-
-### Swift
-40d5d0990 [Swift4] accept empty content with default client
-3b7230b17 [Swift 4] Fix APIHelper to accept array parameter
-e22faf4cd [Swift] Add public initializer for modelObject.
-b184fb1d9 [Swift3] escape URL parameters
-52f606b8d Fix Swift3 test cases and add pom.xml, travis config for iOS test
-a3d0f1d4b Swift4: make generated models structs instead of classes
-
-### TypeScript
-f615d823f update ts node dependencies
-9ac9bc0dc [TypeScript] enhance ts import
-009dcf009 Mark `not required` swagger properties as optional typescript properties
-bdd2c2a4e Misc typescript Angular code generation improvements
-260375c9e Fix typescript-node generation of array type models
-d1933b5fc Fix a problem in the generation of typescript-jquery when we have enum in a query param
-20305139b [Feature][TypeScript] request param enum as literal unions
-524f162e6 Use supportsES6 flag in ts compilation for language typescript-angular
-9b8602311 [TypeScript] Make OpenAPI Generator serialize subclasses properly (#102)
-4bc5ffe86 [typescript-angular] add provided in support (#120)
-ef832e715 [Feature][TS Angular] improve docs angular import
-fc7e08346 [TS][Fetch] Add interfaces option
-157e6b7fa [angular] Add option to generate tagged unions
-7faaa091c Fix generated module imports in Aurelia APIs
-b5f0b24ba [TS] fix object declaration in model
-
-
-## API Servers
-### C++
-6fef0a7ff fix string issue with restbed generator
-a339422bd move get type declaration method to c++ restbed
-
-### C#
-d9d653016 [aspnetcore] Make the use of Swashbuckle optional (#110)
-9a8183ab0 [aspnetcore] Fix openapi.json location rename (#56)
-12abfb968 [aspnetcore] Update Dockerfile
-866817587 [aspnetcore] Fix string enum generation
-
-### Java
-bd50d368e [JAVA - jaxrs-reasteasy-eap] Add import to models (#179)
-7efda597c Fix issue with useBeanValidation option in Java server generators (#160)
-71b5de3ed Do not set contextPath for spring-boot (#104)
-b73ab0260 jaxrs-cxf-cdi: fix outer enum (#131)
-4d7fc046f [JaxRS] Add "validation-api" dependency in jetty (#30)
-ce930e7a6 [Jaxrs-cxf] Add bean-level cascaded beanvalidation for pojos (@Valid)
-386b9f432 Modify "postProcessOperations" for "jaxrs-cxf-client" 
-5d92717dc update jaxrs to listent at port 10080
-7c2031675 update artifict id for jaxrs datelib j8
-88c5112f2 Adds support for returning response in jaxrs-spec interfaces
-6bf84d5fa [JAXRS-SPEC] Fix lowercase enums sent as uppercase
-3a1922bc9 Fix version for "spring-boot-maven-plugin" (#85)
-161948657 Add reactive option for Spring Boot (webflux)
-ff1178ad7 [Java][Spring] fix missing optional query params
-2103fadab Fix package declaration for play-framework
-2c6380c84 fix inner item (list, map) for play framework
-e33b350c8 Fix an issue in Play Framework generator where a CSV is empty and transferred to the controllerImp with an empty item.
-99fc27246 [JAX-RS][Spec] Removes throws Exception.
-fe2a44339 Fixes issue  (SpringCodeGen dateLibrary "java8-localdatetime" option is ignored).
-d890d733f [JaxRS][Java] issue with implFolder on windows, and required fields generation for containers (#88)
-c91ce17ae Feature/javaPlayWithAsynchronousControllers
-f00a1ef52 [JAVA] Correct consumes/produces attributes for Spring Controllers
-d14318cf2 [JAVA][Spring] Optional params with delegate
-3f81378d7 [java resteasy] fix string comparison (#134)
-5ea3d3bb1 [JAX-RS][SPEC] Bug fix that prevents generating interfaces when interfaceOnly is false.
-
-### Kotlin
-7cad47dd3 [kotlin-server] --library=ktor (barebones implementation)
-752b36e66 [Kotlin] Sanitize enumeration name to add underscore when it starts with digits (#77)
-
-### NodeJS
-6d88d073c [NodeJS] make serverPort configurable via CLI option
-e7f4fb3c4 Fix nodejs-server path issue in windows platform
-
-### PHP
-d30fcbabb Fixes for php-ze-ph generator
-60e3339aa [Feature][PHP] Update for ze-ph generator
-
-### Python
-62b93fc5c [Python][Flask] Handles UUID format - 
-9999eac52 fix python flask parameter naming
-
-### Scala
-d5c355a59 [Scalatra] Updated the version of Scalatra to the latest (2.6.2)
-52322c47c [finch] Allow finch server to compile for CI checks (#7)
-
-### Ruby
-dcad9ae80 [Rails5] make version of the generated Rails stub server to strict Rails 5.0
-
-### Rust
-37faaf926 [rust-server] API version constant and composite version support
-6c7813e79 [rust-server] asynchronous support via hyper v0.11
-
-## Documentation
-25a6a9d44 html: fix typo in class name 
-
-
-## Miscellaneous
-f04213285 Cli error message improvements (#172)
-0ece706a4 Remove CodegenConfig.fromModel(String, Schema) method (#90)
-64f2bea37 Fix getReferenced...() methods in ModelUtils (#157)
-16ff5174e Update swagger-parser to 2.0.1 (#123)
-76b7307a6 DefaultGenerator: ignore only form param schemas (#74)
-a3aabd390 Create a default implementation of delegate if none could be autowired (#92)
-ca89af808 Switch to Java 8
-27426f7b5 Cli generator name option, replaces 'language' options in CLI and Maven Plugin (#57)
-a1ff50241 Rename datatype to dataType in CodegenProperty (#69)
-3b9a2a7c3 CaseFormatLambda has been added, params for Rest-assured client has been refactored (#91)
-488910362 Set parameters allowableValues dynamically (#65)
-2821f18b9 Meta: set version for "build-helper-maven-plugin" (#89)
-82d9e935e Add CORS configuration to openapi-generator-online (#71)
-e3814f51d Improvements to online codegen (#55)
-6b8079808 Consider minLength, maxLength and pattern in referenced schema (#45)
-7c5dfbfa0 Minor improvements to OpenAPI Generator Online (#54)
-8dd46a3fb Move online gen from jersey to spring boot (#44)
-803821e21 Fix an issue with example generator when array is too large (#46)
-673f2bc46 Add CodegenProperty.nameInSnakeCase  (#42)
-67ebe17dd Fix isPrimitiveType flag for array of form parameters (#38)
-10ac4024d Code clean-up: remove field declaration hiding existing fields (#35)
-ab9c4b5a6 Code clean-up: Add own private static final LOGGER in each class (#26)
-41b0ff351 Code clean-up: remove DefaultCodegen#getSimpleRef(String) (#19)
-13f084e7b Fix dataTypeWithEnum for array of form parameters
-fd3b883e8 [DefaultCodegen] Fill CodegenOperation::produces with unique media types
-db9a899a0 update getSchemaType variable, remove unused import
-d74b4cdf8 fix map type and collection format for form parameter (array)
-d99f46cff Revise how to obtain the example value
-b1eac05b2 Fix form datatype (array of string)
-3c666a6d4 Fix array of form parameters
-1492df6ce Override server port for Jetty configuration
-622a75b2c Fix data type shadowing
-861d11d01 use vendor extension in operation to set the body parameter name
-80c8b92cb add postProcessParamter for body, form parameter
-7fe555a51 Set collectionFormat default only for array
-16589de97 default collection format to csv according to the spec
-edbe4902a Consider '$ref' for consumes and produces in CodegenOperation
-e24238a35 Improve getter name handling for boolean properties
-6e2ca294b update discriminator to discriminatorName
-74075c087 Primitive datatype in Schema components
-d8abd4a14 support map in body parameter
-186594115 Update swagger-core to 2.0.1
-2034f61e5 Add HideGenerationTimestamp getter and setter in the CodegenConfig interface
-d0e2d7684 Getter and Setter for hideGenerationTimestamp
-adbde2fb6 replace fromOperation with postProcessOperations
-9d1ae0dd2 fix bigdecimal in default codegen
-ffa0e115d fix default value and type declaration
-0e744adb8 Apply collection format to SIMPLE enum style
-36ed29852 Tweak tests according to the parameter order changes
-17b082793 Move 'enum_query_double' to parameters section
-28fcf48f4 Add a method returns discriminator name
-7daa2ec5d Fix broken discriminator
-faa901640 Replace with the helper function: `getTypeDeclaration`
-c8650d0e3 Make optional properties in models optional parameters
-40c30dd2f Fix inputSpec for multi module builds
-5326152cc add option to reorder form/body parameter
-d1850091a Improve JMeter Template
-fedfb0cda Factorize addOption/addSwitch method
-e73eeb4fd fix for stripping prefix on single enums
-13e3db59e Add operationIdOriginal to store the original operationId
-0b2d80569 Expose getter/setter for serverPort to facilitate testing
-8e270f465 add vendorExtensions field in CodegenSecurity class
-1ee85de94 Added Intelli J ignore
-7b8e409cf Added gitignore generation function
+* ### Scala
+* 197b4481e normalize akka-scala and Java README
+* 612cfb7af \[Akka-scala] Clean unused dependencies such swagger-core
+* 86697fedb \[Scala][Gatling] correct body params filename
+* 832919b84 \[Scala][Akka] Remove unused dep when model package is empty
 
+* ### Swift
+* 40d5d0990 \[Swift4] accept empty content with default client
+* 3b7230b17 \[Swift 4] Fix APIHelper to accept array parameter
+* e22faf4cd \[Swift] Add public initializer for modelObject.
+* b184fb1d9 \[Swift3] escape URL parameters
+* 52f606b8d Fix Swift3 test cases and add pom.xml, travis config for iOS test
+* a3d0f1d4b Swift4: make generated models structs instead of classes
+
+* ### TypeScript
+* f615d823f update ts node dependencies
+* 9ac9bc0dc \[TypeScript] enhance ts import
+* 009dcf009 Mark `not required` swagger properties as optional typescript properties
+* bdd2c2a4e Misc typescript Angular code generation improvements
+* 260375c9e Fix typescript-node generation of array type models
+* d1933b5fc Fix a problem in the generation of typescript-jquery when we have enum in a query param
+* 20305139b \[Feature][TypeScript] request param enum as literal unions
+* 524f162e6 Use supportsES6 flag in ts compilation for language typescript-angular
+* 9b8602311 \[TypeScript] Make OpenAPI Generator serialize subclasses properly (#102)
+* 4bc5ffe86 \[typescript-angular] add provided in support (#120)
+* ef832e715 \[Feature][TS Angular] improve docs angular import
+* fc7e08346 \[TS][Fetch] Add interfaces option
+* 157e6b7fa \[angular] Add option to generate tagged unions
+* 7faaa091c Fix generated module imports in Aurelia APIs
+* b5f0b24ba \[TS] fix object declaration in model
+
+* ## API Servers
+* ### C++
+* 6fef0a7ff fix string issue with restbed generator
+* a339422bd move get type declaration method to c++ restbed
+
+* ### C#
+* d9d653016 \[aspnetcore] Make the use of Swashbuckle optional (#110)
+* 9a8183ab0 \[aspnetcore] Fix openapi.json location rename (#56)
+* 12abfb968 \[aspnetcore] Update Dockerfile
+* 866817587 \[aspnetcore] Fix string enum generation
+
+* ### Java
+* bd50d368e \[JAVA - jaxrs-reasteasy-eap] Add import to models (#179)
+* 7efda597c Fix issue with useBeanValidation option in Java server generators (#160)
+* 71b5de3ed Do not set contextPath for spring-boot (#104)
+* b73ab0260 jaxrs-cxf-cdi: fix outer enum (#131)
+* 4d7fc046f \[JaxRS] Add "validation-api" dependency in jetty (#30)
+* ce930e7a6 \[Jaxrs-cxf] Add bean-level cascaded beanvalidation for pojos (@Valid)
+* 386b9f432 Modify "postProcessOperations" for "jaxrs-cxf-client"  
+* 5d92717dc update jaxrs to listent at port 10080
+* 7c2031675 update artifict id for jaxrs datelib j8
+* 88c5112f2 Adds support for returning response in jaxrs-spec interfaces
+* 6bf84d5fa \[JAXRS-SPEC] Fix lowercase enums sent as uppercase
+* 3a1922bc9 Fix version for "spring-boot-maven-plugin" (#85)
+* 161948657 Add reactive option for Spring Boot (webflux)
+* ff1178ad7 \[Java][Spring] fix missing optional query params
+* 2103fadab Fix package declaration for play-framework
+* 2c6380c84 fix inner item (list, map) for play framework
+* e33b350c8 Fix an issue in Play Framework generator where a CSV is empty and transferred to the controllerImp with an empty item.
+* 99fc27246 \[JAX-RS][Spec] Removes throws Exception.
+* fe2a44339 Fixes issue  (SpringCodeGen dateLibrary "java8-localdatetime" option is ignored).
+* d890d733f \[JaxRS][Java] issue with implFolder on windows, and required fields generation for containers (#88)
+* c91ce17ae Feature/javaPlayWithAsynchronousControllers
+* f00a1ef52 \[JAVA] Correct consumes/produces attributes for Spring Controllers
+* d14318cf2 \[JAVA][Spring] Optional params with delegate
+* 3f81378d7 \[java resteasy] fix string comparison (#134)
+* 5ea3d3bb1 \[JAX-RS][SPEC] Bug fix that prevents generating interfaces when interfaceOnly is false.
+
+* ### Kotlin
+* 7cad47dd3 \[kotlin-server] --library=ktor (barebones implementation)
+* 752b36e66 \[Kotlin] Sanitize enumeration name to add underscore when it starts with digits (#77)
+
+* ### NodeJS
+* 6d88d073c \[NodeJS] make serverPort configurable via CLI option
+* e7f4fb3c4 Fix nodejs-server path issue in windows platform
+
+* ### PHP
+* d30fcbabb Fixes for php-ze-ph generator
+* 60e3339aa \[Feature][PHP] Update for ze-ph generator
+
+* ### Python
+* 62b93fc5c \[Python][Flask] Handles UUID format -  
+* 9999eac52 fix python flask parameter naming
+
+* ### Scala
+* d5c355a59 \[Scalatra] Updated the version of Scalatra to the latest (2.6.2)
+* 52322c47c \[finch] Allow finch server to compile for CI checks (#7)
+
+* ### Ruby
+* dcad9ae80 \[Rails5] make version of the generated Rails stub server to strict Rails 5.0
+
+* ### Rust
+* 37faaf926 \[rust-server] API version constant and composite version support
+* 6c7813e79 \[rust-server] asynchronous support via hyper v0.11
+
+* ## Documentation
+* 25a6a9d44 html: fix typo in class name  
 
 
+* ## Miscellaneous
+* f04213285 Cli error message improvements (#172)
+* 0ece706a4 Remove CodegenConfig.fromModel(String, Schema) method (#90)
+* 64f2bea37 Fix getReferenced...() methods in ModelUtils (#157)
+* 16ff5174e Update swagger-parser to 2.0.1 (#123)
+* 76b7307a6 DefaultGenerator: ignore only form param schemas (#74)
+* a3aabd390 Create a default implementation of delegate if none could be autowired (#92)
+* ca89af808 Switch to Java 8
+* 27426f7b5 Cli generator name option, replaces 'language' options in CLI and Maven Plugin (#57)
+* a1ff50241 Rename datatype to dataType in CodegenProperty (#69)
+* 3b9a2a7c3 CaseFormatLambda has been added, params for Rest-assured client has been refactored (#91)
+* 488910362 Set parameters allowableValues dynamically (#65)
+* 2821f18b9 Meta: set version for "build-helper-maven-plugin" (#89)
+* 82d9e935e Add CORS configuration to openapi-generator-online (#71)
+* e3814f51d Improvements to online codegen (#55)
+* 6b8079808 Consider minLength, maxLength and pattern in referenced schema (#45)
+* 7c5dfbfa0 Minor improvements to OpenAPI Generator Online (#54)
+* 8dd46a3fb Move online gen from jersey to spring boot (#44)
+* 803821e21 Fix an issue with example generator when array is too large (#46)
+* 673f2bc46 Add CodegenProperty.nameInSnakeCase  (#42)
+* 67ebe17dd Fix isPrimitiveType flag for array of form parameters (#38)
+* 10ac4024d Code clean-up: remove field declaration hiding existing fields (#35)
+* ab9c4b5a6 Code clean-up: Add own private static final LOGGER in each class (#26)
+* 41b0ff351 Code clean-up: remove DefaultCodegen#getSimpleRef(String) (#19)
+* 13f084e7b Fix dataTypeWithEnum for array of form parameters
+* fd3b883e8 \[DefaultCodegen] Fill CodegenOperation::produces with unique media types
+* db9a899a0 update getSchemaType variable, remove unused import
+* d74b4cdf8 fix map type and collection format for form parameter (array)
+* d99f46cff Revise how to obtain the example value
+* b1eac05b2 Fix form datatype (array of string)
+* 3c666a6d4 Fix array of form parameters
+* 1492df6ce Override server port for Jetty configuration
+* 622a75b2c Fix data type shadowing
+* 861d11d01 use vendor extension in operation to set the body parameter name
+* 80c8b92cb add postProcessParamter for body, form parameter
+* 7fe555a51 Set collectionFormat default only for array
+* 16589de97 default collection format to csv according to the spec
+* edbe4902a Consider '$ref' for consumes and produces in CodegenOperation
+* e24238a35 Improve getter name handling for boolean properties
+* 6e2ca294b update discriminator to discriminatorName
+* 74075c087 Primitive datatype in Schema components
+* d8abd4a14 support map in body parameter
+* 186594115 Update swagger-core to 2.0.1
+* 2034f61e5 Add HideGenerationTimestamp getter and setter in the CodegenConfig interface
+* d0e2d7684 Getter and Setter for hideGenerationTimestamp
+* adbde2fb6 replace fromOperation with postProcessOperations
+* 9d1ae0dd2 fix bigdecimal in default codegen
+* ffa0e115d fix default value and type declaration
+* 0e744adb8 Apply collection format to SIMPLE enum style
+* 36ed29852 Tweak tests according to the parameter order changes
+* 17b082793 Move 'enum_query_double' to parameters section
+* 28fcf48f4 Add a method returns discriminator name
+* 7daa2ec5d Fix broken discriminator
+* faa901640 Replace with the helper function: `getTypeDeclaration`
+* c8650d0e3 Make optional properties in models optional parameters
+* 40c30dd2f Fix inputSpec for multi module builds
+* 5326152cc add option to reorder form/body parameter
+* d1850091a Improve JMeter Template
+* fedfb0cda Factorize addOption/addSwitch method
+* e73eeb4fd fix for stripping prefix on single enums
+* 13e3db59e Add operationIdOriginal to store the original operationId
+* 0b2d80569 Expose getter/setter for serverPort to facilitate testing
+* 8e270f465 add vendorExtensions field in CodegenSecurity class
+* 1ee85de94 Added Intelli J ignore
+* 7b8e409cf Added gitignore generation function

docs/building.md

@@ -0,0 +1,76 @@
+---
+id: contribute-building
+title: Building the code
+---
+
+## Using Maven
+
+To build from source, you need the following installed and available in your `$PATH:`
+
+* [Java 8](http://java.oracle.com)
+
+* [Apache maven 3.3.4 or greater](http://maven.apache.org/)
+
+After cloning the project, you can build it from source with this command:
+
+```bash
+mvn clean install
+```
+
+If you don't have maven installed, you may directly use the included [maven wrapper](https://github.com/takari/maven-wrapper), and build with the command:
+
+```bash
+./mvnw clean install
+```
+
+## Using Docker
+
+You can use `run-in-docker.sh` to do all development. This script maps your local repository to `/gen`
+in the docker container. It also maps `~/.m2/repository` to the appropriate container location.
+
+To execute `mvn package`:
+
+```bash
+git clone https://github.com/openapitools/openapi-generator
+cd openapi-generator
+./run-in-docker.sh mvn package
+```
+
+Build artifacts are now accessible in your working directory.
+
+Once built, `run-in-docker.sh` will act as an executable for openapi-generator-cli. To generate code, you'll need to output to a directory under `/gen` (e.g. `/gen/out`). For example:
+
+```bash
+./run-in-docker.sh help # Executes 'help' command for openapi-generator-cli
+./run-in-docker.sh list # Executes 'list' command for openapi-generator-cli
+./run-in-docker.sh /gen/bin/go-petstore.sh  # Builds the Go client
+./run-in-docker.sh generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
+    -g go -o /gen/out/go-petstore -DpackageName=petstore # generates go client, outputs locally to ./out/go-petstore
+```
+
+### Docker in Vagrant
+
+Prerequisite: install [Vagrant](https://www.vagrantup.com/downloads.html) and [VirtualBox](https://www.virtualbox.org/wiki/Downloads).
+
+```bash
+git clone http://github.com/openapitools/openapi-generator.git
+cd openapi-generator
+vagrant up
+vagrant ssh
+cd /vagrant
+./run-in-docker.sh mvn package
+```
+
+### Troubleshooting
+
+If an error like this occurs, just execute the **mvn clean install -U** command:
+
+> org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test (default-test) on project openapi-generator: A type incompatibility occurred while executing org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test: java.lang.ExceptionInInitializerError cannot be cast to java.io.IOException
+
+```bash
+./run-in-docker.sh mvn clean install -U
+```
+
+> Failed to execute goal org.fortasoft:gradle-maven-plugin:1.0.8:invoke (default) on project openapi-generator-gradle-plugin-mvn-wrapper: org.gradle.tooling.BuildException: Could not execute build using Gradle distribution 'https://services.gradle.org/distributions/gradle-4.7-bin.zip'
+
+Right now: no solution for this one :|

docs/conduct.md

@@ -0,0 +1,49 @@
+---
+id: code-of-conduct
+title: Code of Conduct
+---
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at team@openapitools.org. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

docs/contributing.md

@@ -0,0 +1,107 @@
+---
+id: contributing
+title: Guidelines For Contributing
+sidebar_label: Guidelines
+---
+
+## Before submitting an issue
+
+ - If you're not using the latest master to generate API clients or server stubs, please give it another try by pulling the latest master as the issue may have already been addressed. Ref: [Getting Started](https://github.com/openapitools/openapi-generator#getting-started)
+ - Search the [open issue](https://github.com/openapitools/openapi-generator/issues) and [closed issue](https://github.com/openapitools/openapi-generator/issues?q=is%3Aissue+is%3Aclosed) to ensure no one else has reported something similar before.
+ - File an [issue ticket](https://github.com/openapitools/openapi-generator/issues/new) by providing all the required information.
+ - Test with the latest master by building the JAR locally to see if the issue has already been addressed.
+ - You can also make a suggestion or ask a question by opening an "issue".
+
+## Before submitting a PR
+
+ - Search the [open issue](https://github.com/openapitools/openapi-generator/issues) to ensure no one else has reported something similar and no one is actively working on similar proposed change.
+ - If no one has suggested something similar, open an ["issue"](https://github.com/openapitools/openapi-generator/issues) with your suggestion to gather feedback from the community.
+ - If you're adding a new option to a generator, please consider using the `-t` option with customized templates instead or start a discussion first by opening an issue as we want to avoid adding too many options to the generator.
+ - It's recommended to **create a new git branch** for the change so that the merge commit message looks nicer in the commit history.
+
+## How to contribute
+
+### git
+
+If you're new to git, you may find the following FAQs useful:
+
+https://github.com/openapitools/openapi-generator/wiki/FAQ#git
+
+### Branches
+
+Please file the pull request against the correct branch, e.g. `master` for non-breaking changes. See the [Git Branches](https://github.com/OpenAPITools/openapi-generator/wiki/Git-Branches) page for more information.
+
+### Code generators
+
+All the code generators can be found in [modules/openapi-generator/src/main/java/org/openapitools/codegen/languages](https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages)
+
+### Templates
+
+All the templates ([mustache](https://mustache.github.io/)) can be found in [modules/openapi-generator/src/main/resources](https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources).
+
+For a list of variables available in the template, please refer to this [page](https://github.com/openapitools/openapi-generator/wiki/Mustache-Template-Variables)
+
+
+### Style guide
+Code change should conform to the programming style guide of the respective languages:
+- Ada: https://en.wikibooks.org/wiki/Ada_Style_Guide/Source_Code_Presentation
+- Android: https://source.android.com/source/code-style.html
+- Bash: https://github.com/bahamas10/bash-style-guide
+- C#: https://msdn.microsoft.com/en-us/library/vstudio/ff926074.aspx
+- C++: https://google.github.io/styleguide/cppguide.html
+- C++ (Tizen): https://wiki.tizen.org/Native_Platform_Coding_Idiom_and_Style_Guide#C.2B.2B_Coding_Style
+- Clojure: https://github.com/bbatsov/clojure-style-guide
+- Dart: https://www.dartlang.org/guides/language/effective-dart/style
+- Elixir: https://github.com/christopheradams/elixir_style_guide
+- Eiffel: https://www.eiffel.org/doc/eiffel/Coding%20Standards
+- Erlang: https://github.com/inaka/erlang_guidelines
+- Haskell: https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md
+- Java: https://google.github.io/styleguide/javaguide.html
+- JavaScript: https://github.com/airbnb/javascript/
+- Kotlin: https://kotlinlang.org/docs/reference/coding-conventions.html
+- Groovy: http://groovy-lang.org/style-guide.html
+- Go: https://github.com/golang/go/wiki/CodeReviewComments
+- ObjC: https://github.com/NYTimes/objective-c-style-guide
+- Perl: http://perldoc.perl.org/perlstyle.html
+- PHP: https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md
+- PowerShell: https://msdn.microsoft.com/en-us/library/dd878270(v=vs.85).aspx
+- Python: https://www.python.org/dev/peps/pep-0008/
+- R: https://google.github.io/styleguide/Rguide.xml
+- Ruby: https://github.com/bbatsov/ruby-style-guide
+- Rust: https://github.com/rust-lang-nursery/fmt-rfcs/blob/master/guide/guide.md (the default [rustfmt](https://github.com/rust-lang-nursery/rustfmt) configuration)
+- Scala: http://docs.scala-lang.org/style/
+- Swift: [Apple Developer](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/TheBasics.html)
+- TypeScript: https://github.com/Microsoft/TypeScript/wiki/Coding-guidelines
+
+For other languages, feel free to suggest.
+
+You may find the current code base not 100% conform to the coding style and we welcome contributions to fix those.
+
+For [Vendor Extensions](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#vendorExtensions), please follow the naming convention below:
+- For general vendor extension, use lower case and hyphen. e.g. `x-is-unique`, `x-content-type`
+- For language-specified vendor extension, put it in the form of `x-{lang}-{extension-name}`. e.g. `x-objc-operation-id`, `x-java-feign-retry-limit`
+- For a list of existing vendor extensions in use, please refer to https://github.com/openapitools/openapi-generator/wiki/Vendor-Extensions. If you've added new vendor extensions as part of your PR, please update the wiki page.
+
+### Testing
+
+To add test cases (optional) covering the change in the code generator, please refer to [modules/openapi-generator/src/test/java/org/openapitools/codegen](https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/test/java/org/openapitools/codegen)
+
+To test the templates, please perform the following:
+- Update the Petstore sample by running the shell script under `bin` folder. For example, run `./bin/ruby-petstore.sh` to update the Ruby PetStore API client under [`samples/client/petstore/ruby`](https://github.com/openapitools/openapi-generator/tree/master/samples/client/petstore/ruby) For Windows, the batch files can be found under `bin\windows` folder. (If you find that there are new files generated or unexpected changes as a result of the update, that's not unusual as the test cases are added to the OpenAPI spec from time to time. If you've questions or concerns, please open a ticket to start a discussion)
+- Run the tests in the sample folder, e.g. in `samples/client/petstore/ruby`, run `mvn integration-test -rf :RubyPetstoreClientTests`. (some languages may not contain unit testing for Petstore and we're looking for contribution from the community to implement those tests)
+- Finally, git commit the updated samples files: `git commit -a`
+  (`git add -A` if added files with new test cases)
+- For new test cases, please add to the [Fake Petstore spec](https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml)
+
+To start the CI tests, you can run `mvn verify -Psamples` (assuming you've all the required tools installed to run tests for different languages) or you can leverage http://travis-ci.org to run the CI tests by adding your own openapi-generator repository.
+
+### Tips
+- Smaller changes are easier to review
+- [Optional] For bug fixes, provide a OpenAPI Spec to repeat the issue so that the reviewer can use it to confirm the fix
+- Add test case(s) to cover the change
+- Document the fix in the code to make the code more readable
+- Make sure test cases passed after the change (one way is to leverage https://travis-ci.org/ to run the CI tests)
+- File a PR with meaningful title, description and commit messages.
+- Recommended git settings
+   - `git config --global core.autocrlf input` to tell Git convert CRLF to LF on commit but not the other way around 
+- To close an issue (e.g. issue 1542) automatically after a PR is merged, use keywords "fix", "close", "resolve" in the PR description, e.g. `fix #1542`. (Ref: [closing issues using keywords](https://help.github.com/articles/closing-issues-using-keywords/))

docs/core-team.md

@@ -0,0 +1,12 @@
+---
+id: core-team
+title: Core Team Members
+---
+
+* [@wing328](https://github.com/wing328) (2015/07)
+* [@jimschubert](https://github.com/jimschubert) (2016/05)
+* [@cbornet](https://github.com/cbornet) (2016/05)
+* [@jaz-ah](https://github.com/jaz-ah) (2016/05)
+* [@ackintosh](https://github.com/ackintosh) (2018/02)
+* [@JFCote](https://github.com/JFCote) (2018/03)
+* [@jmini](https://github.com/jmini) (2018/04)

docs/customization.md

@@ -1,26 +1,9 @@
-## Customization
+---
+id: customization
+title: Customization
+---
 
-### Modifying a template
-
-Clone OpenAPI Generator and navigate to `modules/openapi-generator/src/main/resources/${template}`, where `${template}` is the name of the generator you wish to modify. For example, if you are looking for the C# template, it's named `csharp`.  This directory contains all the templates used to generate your target client/server/doc output.
-
-Templates consist of multiple mustache files. [Mustache](https://mustache.github.io/) is used as the templating language for these templates, and the specific engine used is [jmustache](https://github.com/samskivert/jmustache).
-
-If you wish to modify one of these templates, copy and paste the template you're interested in to a templates directory you control. To let OpenAPI Generator know where this templates directory is, use the `-t` option (e.g: `-t ./templates/`).
-
-To tie that all together (example for modifying ruby templates):
-
-```sh
-mkdir templates
-export template=ruby
-cp -r modules/openapi-generator/src/main/resources/${template} templates/${template}
-java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
-  -t ./templates/${template} -g ruby -i ./foo.yml -o ./out/ruby
-```
-
-_**Note:** You cannot use this approach to create new templates, only override existing ones. If you'd like to create a new generator within the project, see `new.sh` in the repository root._
-
-### Creating a new template
+## Creating a new template
 
 If none of the templates suit your needs, you can create a brand new template. OpenAPI Generator can help with this, using the `meta` command:
 
@@ -35,7 +18,7 @@ These names can be anything you like. If you are building a client for the white
 
 **NOTE** Convention is to use kebab casing for names passed to `-n`. Example, `scala-finatra` would become `ScalaFinatraGenerator`.
 
-#### Use your new generator with the CLI
+### Use your new generator with the CLI
 
 To compile your library, enter the `out/generators/my-codegen` directory, run `mvn package` and execute the generator:
 
@@ -65,7 +48,7 @@ java -cp out/codegens/customCodegen/target/my-codegen-openapi-generator-1.0.0.ja
   -o ./out/myClient
 ```
 
-#### Use your new generator with the maven plugin
+### Use your new generator with the maven plugin
 
 Install your library to your local maven repository by running:
 
@@ -106,7 +89,7 @@ You can use this as additional dependency of the `openapi-generator-maven-plugin
 
 If you publish your artifact to a distant maven repository, do not forget to add this repository as `pluginRepository` for your project.
 
-### Selective generation
+## Selective generation
 You may not want to generate *all* models in your project.  Likewise you may want just one or two apis to be written.  If that's the case, you can use system properties to control the output:
 
 The default is generate *everything* supported by the specific library.  Once you enable a feature, it will restrict the contents generated:
@@ -164,7 +147,7 @@ java -DskipFormModel=true
 
 This option will be helpful to skip model generation due to the form parameter, which is defined differently in OAS3 as there's no form parameter in OAS3
 
-### Ignore file format
+## Ignore file format
 
 OpenAPI Generator supports a `.openapi-generator-ignore` file, similar to `.gitignore` or `.dockerignore` you're probably already familiar with.
 
@@ -206,7 +189,7 @@ Upon first code generation, you may also pass the CLI option `--ignore-file-over
 
 Editor support for `.openapi-generator-ignore` files is available in IntelliJ via the [.ignore plugin](https://plugins.jetbrains.com/plugin/7495--ignore).
 
-### Customizing the generator
+## Customizing the generator
 
 There are different aspects of customizing the code generator beyond just creating or modifying templates.  Each language has a supporting configuration file to handle different type mappings, etc:
 
@@ -300,7 +283,7 @@ and specify the `classname` when running the generator:
 
 Your subclass will now be loaded and overrides the `PREFIX` value in the superclass.
 
-### Bringing your own models
+## Bringing your own models
 
 Sometimes you don't want a model generated.  In this case, you can simply specify an import mapping to tell
 the codegen what _not_ to create.  When doing this, every location that references a specific model will

docs/debugging.md

@@ -0,0 +1,64 @@
+---
+id: debugging
+title: Debugging
+---
+
+## Templates
+
+Sometimes, you may have issues with variables in your templates. As discussed in the [templating](./templating.md) docs, we offer a variety of system properties for inspecting the models bound to templates.
+
+<dl>
+<dt><code>-DdebugOpenAPI</code></dt>
+<dd>Prints out the JSON model of the OpenAPI Document, as seen by OpenAPI Generator</dd>
+<dt><code>-DdebugModels</code></dt>
+<dd>Prints out the JSON model passed to model templates</dd>
+<dt><code>-DdebugOperations</code></dt>
+<dd>Prints out the JSON model passed to operation (api) templates</dd>
+<dt><code>-DdebugSupportingFiles</code></dt>
+<dd>Prints out the JSON model passed to supporting files</dd>
+</dl>
+
+One or more of these properties can be passed alongside other command line options:
+
+```bash
+openapi-generator generate -g go \
+    -o out \
+    -i petstore-minimal.yaml \
+    -DdebugModels \
+    -DdebugOperations
+```
+
+Or you can add these to your `JAVA_OPTS` environment variable (this applies to every invocation of the tool):
+
+```bash
+export JAVA_OPTS="${JAVA_OPTS} -DdebugModels -DdebugOperations"
+```
+
+> NOTE: Globally available system options like these will apply to all invocations of the generator (CLI and plugins)
+
+## Runtime
+
+When you're working with a custom generator, a new generator, or otherwise trying to understand the behavior of the toolset, you may need to attach a remote debugger in order to step through the code.
+
+The steps are shown here for a specific version of the generator, but apply the same if you're working off master or a feature branch.
+
+* Determine the version of `openapi-generator` you're using. For the CLI, this is:  
+  ```
+  openapi-generator version
+  ```
+* Navigate to the `openapi-generator` source directory (see [building](./building.md) docs for obtaining source code and brief introduction).
+* Checkout the branch/tag for the target version. Branches are not prefixed, but tags are prefixed with a `v`. For instance if you're using version `3.3.0`, you will execute:
+  ```
+  git checkout v3.3.0
+  ```
+* Open the project in your IDE.
+* Setup your IDE for remote debugging. You'll want to define a port used for connecting the remote debugger. For this example, we'll use `5005`. See external tutorials for [IntelliJ](https://www.jetbrains.com/help/idea/run-debug-configuration-remote-debug.html) and [Eclipse](https://www.ibm.com/developerworks/library/os-eclipse-javadebug/index.html)
+* Export the debug configuration, specifying `suspend=y` so you have time to attach a remote debugger. These are passed as Java system properties, either on command line or as part of the `JAVA_OPTS` environment variable. This will look like:
+  ```
+  export JAVA_OPTS="${JAVA_OPTS} -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5005"
+  ```
+* Execute the generator with your desired options. You should see the application output _only_
+  ```
+  Listening for transport dt_socket at address: 5005
+  ```
+* Set breakpoints in code, and then attach your remote debugger from your IDE (see above). The generator will automatically unblock once the remote debugger is attached. You can now step through the code.

docs/faq-contributing.md

@@ -0,0 +1,66 @@
+---
+id: faq-contributing
+title: FAQ: Contributing
+---
+
+## Automated checks on my PR have failed. Do you know what's wrong?
+
+Please do the following:
+
+* Click on the failed tests and check the log to see what's causing the errors.
+* If it's related to connection timeout in downloading dependencies, please restart the CI jobs (which can be done by closing and reopening the PR)
+* If it's some other reason, please tag someone on the [core team](./core-team.md) for assistance.
+
+## The public petstore server returns status 500, can I run it locally?
+
+Yes, please run the following commands (assuming you've docker installed):
+
+```
+docker pull swaggerapi/petstore
+docker run -d -e SWAGGER_HOST=http://petstore.swagger.io -e SWAGGER_BASE_PATH=/v2 -p 80:8080 swaggerapi/petstore
+docker ps -a
+```
+ 
+Then add the following to your local [hosts](https://en.wikipedia.org/wiki/Hosts_%28file%29) table:
+
+```
+127.0.0.1    petstore.swagger.io
+```
+
+## Who should I report a security vulnerability to?
+
+Please contact team@openapitools.org with the details and we'll follow up with you.
+
+
+## How can I rebase my PR on the latest master?
+
+Please refer to http://rypress.com/tutorials/git/rebasing, or follow the steps below (assuming the branch for the PR is "fix_issue_9999"):
+
+1. git checkout master
+2. git pull upstream master (assuming `upstream` is pointing to the official repo)
+3. git checkout fix_issue_9999
+4. git rebase master
+5. Resolve merge conflicts, if any, and run "git commit -a"
+6. Rebase done (you may need to add --force when doing `git push`)
+
+(To setup `upstream` pointing to the official repo, please run `git remote add upstream  https://github.com/openapitools/openapi-generator.git`)
+
+## How can I update commits that are not linked to my Github account?
+
+Please refer to https://stackoverflow.com/questions/3042437/how-to-change-the-commit-author-for-one-specific-commit or you can simply add the email address in the commit as your secondary email address in your Github account.
+
+## Any useful git tips to share?
+
+Yes, http://www.alexkras.com/19-git-tips-for-everyday-use/
+
+## How can I submit a PR to fix bugs or make enhancements?
+
+Visit https://github.com/openapitools/openapi-generator and then click on the "Fork" button in the upper right corner. Then in your local machine, run the following (assuming your github ID is "your_user_id")
+
+1) git clone https://github.com/your_user_id/openapi-generator.git
+2) cd openapi-generator
+3) git checkout -b fix_issue9999
+4) make changes
+5) git commit -a (you may need to use `git add filename` to add new files)
+6) git push origin fix_issue9999
+7) Visit https://github.com/openapitools/openapi-generator in your browser and click on the button to file a new PR based on fix_issue9999

docs/faq-extending.md

@@ -0,0 +1,40 @@
+---
+id: faq-extending
+title: FAQ: Extending
+---
+
+## How do I use my own Java models?
+
+See [Bringing your own Models](./customization.md#bringing-your-own-models).
+
+## How do I disable certificate verification?
+
+Please add `-Dio.swagger.v3.parser.util.RemoteUrl.trustAll=true` when generating the code.
+
+## How do I skip files during code generation?
+
+OpenAPI Generator has a built-in ignore file processor.
+
+For example, to skip `git_push.sh`, one can create a file named `.openapi-generator-ignore` in the root of the output directory with the contents:
+ 
+```
+# Prevent generator from creating these files:
+git_push.sh
+```
+
+The ignore file works just like .gitignore, and it is auto-generated by default.
+
+If you need this functionality on initial generation, you can provide the option `--ignore-file-override` (CLI) or `ignoreFileOverride` (Maven and Gradle plugins) with a value targeting any existing file. The contents of that file will be evaluated relative to the output directory.
+
+
+## How can I customize the auto-generated code?
+
+Variants:
+
+* "How can I add a header/footer to generated code?"
+* "How can I add my own logging to generated code?"
+* "How can I add my license to the top of files?"
+
+OpenAPI Generator supports user-defined templates without need to recompile the artifact. We also support custom generators (templates and logic) if those generators are accessible on the classpath.
+
+See [templating: Modifying Templates](./templating.md#modifying-templates) and [customization](./customization.md) docs for more details.

docs/faq-generators.md

@@ -0,0 +1,115 @@
+---
+id: faq-generators
+title: FAQ: Generators
+---
+
+### What are some server generator use cases?
+
+We have around 40+ server generators, with more added regularly. Some of these include Spring in your choice of Java or Kotlin, the Finch and Scalatra frameworks using Scala, and C# generators for NancyFX and WebAPI (to name only a few).
+
+Besides generating the server code as a starting point to implement the API backend, here are some use cases of the server generators:
+
+* **prototyping** - one can generate the server code and have a functional API backend very quickly to try different things or features.
+* **mocking** - easily provide an API backend for mocking based on the examples field defined in the response object.
+* **migration** - let's say one wants to migrate an API backend from Ruby on Rails to Java Spring. The server generator can save a lot of time in implementing and verify each endpoint in the new API backend.
+* **evaluating** - when you want to try a new language or framework, and a typical "Hello, World" is too trivial.
+
+## Java
+
+### The API client has SSL errors due to an invalid certificate. Is there a way to bypass that?
+
+Yes, please refer to http://stackoverflow.com/a/6055903/677735
+
+### How can I customize the Feign client templates?
+
+You will need to provide customized files in `Java/libraries/feign` under the resources folder and pass the location via the `-t` option.
+
+In your Gradle build script, please add the following (example):
+```
+config.templateDir = 'src/openapi-generator-templates/Java/libraries/feign
+```
+
+## Android
+
+### How can I generate an Android SDK?
+
+**The Java SDK is also compatible with Android.**
+
+[RECOMMENDED] To generate the Java SDK with `okhttp` and `gson` libraries, run the following:
+```
+mvn clean package
+java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
+  -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.json \
+  -l java --library=okhttp-gson \
+  -D hideGenerationTimestamp=true \
+  -o /var/tmp/java/okhttp-gson/ 
+```
+
+You can also generate the Java SDK with other HTTP libraries by replacing `okhttp-gson` with `retrofit` for example. For a list of support libraries, please run
+
+```
+java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -l java
+```  
+
+To generate the Android SDK with [`volley`](https://github.com/mcxiaoke/android-volley), please run
+```
+mvn clean package
+java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
+  -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.json \
+  -l android --library=volley \
+  -o /var/tmp/android/volley/ 
+```
+We do **not** recommend using the default HTTP library (Apache HttpClient) with `android` as it's not actively maintained.
+
+## C-Sharp
+
+### How do I fix `CSC:  warning CS2002` in Xamarin?
+
+The full warning might look like this: `CSC:  warning CS2002: Source file 'Api/FakeApi.cs' specified multiple times`
+
+The warning has no impact on the build process so you should be able to build the solution without issue. The warning should be addressed in the upcoming stable release of Xamarin. 
+
+## Objective-C
+
+### How do I run integration test with Petstore ObjC API client?
+
+Here are the steps:
+```
+git clone https://github.com/openapitools/openapi-generator.git
+cd openapi-generator/samples/client/petstore/objc/default/OpenAPIClientTests
+mvn integration-test
+```
+
+Besides `default` (folder) ObjC API client, there's also `core-data` for another ObjC API client with [Core Data support](https://en.wikipedia.org/wiki/Core_Data).
+
+## Swift
+
+### How do I run integration test with Petstore Swift API client?
+
+Here are the steps:
+```
+git clone https://github.com/openapitools/openapi-generator.git
+cd openapi-generator/samples/client/petstore/swift/default/OpenAPIClientTests
+mvn integration-test
+```
+Besides `default` (folder), there's another folder `promisekit` for Swift API client with [PromiseKit support](https://github.com/mxcl/PromiseKit)
+```
+git clone https://github.com/openapitools/openapi-generator.git
+cd openapi-generator/samples/client/petstore/swift/promisekit/OpenAPIClientTests
+mvn integration-test
+```
+
+### Is Swift (2.x) generator still actively maintained?
+
+No, please use `swift3` or `swift4` generator instead as we want to focus on Swift 3.x, 4.x.
+
+## TypeScript
+
+### The JSON response fails to deserialize due to change in variable naming (snake_case to camelCase). Is there any way to keep the original naming?
+
+Yes, please use the following option when generating TypeScript clients:
+
+```
+	modelPropertyNaming
+	    Naming convention for the property: 'camelCase', 'PascalCase', 'snake_case' and 'original', which keeps the original name (Default: camelCase)
+```

docs/faq.md

@@ -0,0 +1,18 @@
+---
+id: faq
+title: FAQ: General
+---
+
+## Do you have a chat room?
+
+[![Gitter](https://img.shields.io/gitter/room/:user/:repo.svg?style=for-the-badge)](https://gitter.im/OpenAPITools/openapi-generator)  
+
+## What is the governance structure of the OpenAPI Generator project?
+
+OpenAPI generator (openapi-generator) is managed by the members of the [core team](./core-team.md).
+
+## What is the difference between Swagger Codegen and OpenAPI Generator?
+
+Swagger Codegen is driven by SmartBear while OpenAPI Generator is driven by the community. More than 40 top contributors and template creators of Swagger Codegen have joined OpenAPI Generator as the founding team members. For more details, see the [Fork Q&A](./qna.md).
+
+Swagger is a trademark owned by SmartBear and the use of the term "Swagger" in this project is for demo (reference) purposes only.

docs/generators.md

@@ -0,0 +1,126 @@
+---
+id: generators
+title: Generators List
+---
+
+The following generators are available:
+
+* CLIENT generators:
+    - [ada](generators/ada.md)
+    - [android](generators/android.md)
+    - [apex](generators/apex.md)
+    - [bash](generators/bash.md)
+    - [c](generators/c.md)
+    - [clojure](generators/clojure.md)
+    - [cpp-qt5-client](generators/cpp-qt5-client.md)
+    - [cpp-restsdk](generators/cpp-restsdk.md)
+    - [cpp-tizen](generators/cpp-tizen.md)
+    - [csharp](generators/csharp.md)
+    - [csharp-dotnet2](generators/csharp-dotnet2.md)
+    - [csharp-refactor](generators/csharp-refactor.md)
+    - [dart](generators/dart.md)
+    - [dart-jaguar](generators/dart-jaguar.md)
+    - [eiffel](generators/eiffel.md)
+    - [elixir](generators/elixir.md)
+    - [elm](generators/elm.md)
+    - [erlang-client](generators/erlang-client.md)
+    - [erlang-proper](generators/erlang-proper.md)
+    - [flash](generators/flash.md)
+    - [go](generators/go.md)
+    - [groovy](generators/groovy.md)
+    - [haskell-http-client](generators/haskell-http-client.md)
+    - [java](generators/java.md)
+    - [javascript](generators/javascript.md)
+    - [javascript-closure-angular](generators/javascript-closure-angular.md)
+    - [javascript-flowtyped](generators/javascript-flowtyped.md)
+    - [jaxrs-cxf-client](generators/jaxrs-cxf-client.md)
+    - [jmeter](generators/jmeter.md)
+    - [kotlin](generators/kotlin.md)
+    - [lua](generators/lua.md)
+    - [objc](generators/objc.md)
+    - [perl](generators/perl.md)
+    - [php](generators/php.md)
+    - [powershell](generators/powershell.md)
+    - [python](generators/python.md)
+    - [r](generators/r.md)
+    - [ruby](generators/ruby.md)
+    - [rust](generators/rust.md)
+    - [scala-akka](generators/scala-akka.md)
+    - [scala-gatling](generators/scala-gatling.md)
+    - [scala-httpclient](generators/scala-httpclient.md)
+    - [scalaz](generators/scalaz.md)
+    - [swift2-deprecated](generators/swift2-deprecated.md)
+    - [swift3-deprecated](generators/swift3-deprecated.md)
+    - [swift4](generators/swift4.md)
+    - [typescript-angular](generators/typescript-angular.md)
+    - [typescript-angularjs](generators/typescript-angularjs.md)
+    - [typescript-aurelia](generators/typescript-aurelia.md)
+    - [typescript-axios](generators/typescript-axios.md)
+    - [typescript-fetch](generators/typescript-fetch.md)
+    - [typescript-inversify](generators/typescript-inversify.md)
+    - [typescript-jquery](generators/typescript-jquery.md)
+    - [typescript-node](generators/typescript-node.md)
+
+
+* SERVER generators:
+    - [ada-server](generators/ada-server.md)
+    - [aspnetcore](generators/aspnetcore.md)
+    - [cpp-pistache-server](generators/cpp-pistache-server.md)
+    - [cpp-qt5-qhttpengine-server](generators/cpp-qt5-qhttpengine-server.md)
+    - [cpp-restbed-server](generators/cpp-restbed-server.md)
+    - [csharp-nancyfx](generators/csharp-nancyfx.md)
+    - [erlang-server](generators/erlang-server.md)
+    - [go-gin-server](generators/go-gin-server.md)
+    - [go-server](generators/go-server.md)
+    - [graphql-server](generators/graphql-server.md)
+    - [haskell](generators/haskell.md)
+    - [java-inflector](generators/java-inflector.md)
+    - [java-msf4j](generators/java-msf4j.md)
+    - [java-pkmst](generators/java-pkmst.md)
+    - [java-play-framework](generators/java-play-framework.md)
+    - [java-undertow-server](generators/java-undertow-server.md)
+    - [java-vertx](generators/java-vertx.md)
+    - [jaxrs-cxf](generators/jaxrs-cxf.md)
+    - [jaxrs-cxf-cdi](generators/jaxrs-cxf-cdi.md)
+    - [jaxrs-jersey](generators/jaxrs-jersey.md)
+    - [jaxrs-resteasy](generators/jaxrs-resteasy.md)
+    - [jaxrs-resteasy-eap](generators/jaxrs-resteasy-eap.md)
+    - [jaxrs-spec](generators/jaxrs-spec.md)
+    - [kotlin-server](generators/kotlin-server.md)
+    - [kotlin-spring](generators/kotlin-spring.md)
+    - [nodejs-server](generators/nodejs-server.md)
+    - [php-laravel](generators/php-laravel.md)
+    - [php-lumen](generators/php-lumen.md)
+    - [php-silex](generators/php-silex.md)
+    - [php-slim](generators/php-slim.md)
+    - [php-symfony](generators/php-symfony.md)
+    - [php-ze-ph](generators/php-ze-ph.md)
+    - [python-flask](generators/python-flask.md)
+    - [ruby-on-rails](generators/ruby-on-rails.md)
+    - [ruby-sinatra](generators/ruby-sinatra.md)
+    - [rust-server](generators/rust-server.md)
+    - [scala-finch](generators/scala-finch.md)
+    - [scala-lagom-server](generators/scala-lagom-server.md)
+    - [scalatra](generators/scalatra.md)
+    - [spring](generators/spring.md)
+
+
+* DOCUMENTATION generators:
+    - [cwiki](generators/cwiki.md)
+    - [dynamic-html](generators/dynamic-html.md)
+    - [html](generators/html.md)
+    - [html2](generators/html2.md)
+    - [openapi](generators/openapi.md)
+    - [openapi-yaml](generators/openapi-yaml.md)
+
+
+* SCHEMA generators:
+    - [mysql-schema](generators/mysql-schema.md)
+
+
+* CONFIG generators:
+    - [apache2](generators/apache2.md)
+    - [graphql-schema](generators/graphql-schema.md)
+
+
+

docs/generators/README.md

@@ -5,18 +5,21 @@ The following generators are available:
     - [android](android.md)
     - [apex](apex.md)
     - [bash](bash.md)
+    - [c](c.md)
     - [clojure](clojure.md)
-    - [cpp-qt5](cpp-qt5.md)
+    - [cpp-qt5-client](cpp-qt5-client.md)
     - [cpp-restsdk](cpp-restsdk.md)
     - [cpp-tizen](cpp-tizen.md)
     - [csharp](csharp.md)
     - [csharp-dotnet2](csharp-dotnet2.md)
+    - [csharp-refactor](csharp-refactor.md)
     - [dart](dart.md)
     - [dart-jaguar](dart-jaguar.md)
     - [eiffel](eiffel.md)
     - [elixir](elixir.md)
     - [elm](elm.md)
     - [erlang-client](erlang-client.md)
+    - [erlang-proper](erlang-proper.md)
     - [flash](flash.md)
     - [go](go.md)
     - [groovy](groovy.md)
@@ -42,7 +45,7 @@ The following generators are available:
     - [scala-httpclient](scala-httpclient.md)
     - [scalaz](scalaz.md)
     - [swift2-deprecated](swift2-deprecated.md)
-    - [swift3](swift3.md)
+    - [swift3-deprecated](swift3-deprecated.md)
     - [swift4](swift4.md)
     - [typescript-angular](typescript-angular.md)
     - [typescript-angularjs](typescript-angularjs.md)
@@ -64,6 +67,7 @@ The following generators are available:
     - [erlang-server](erlang-server.md)
     - [go-gin-server](go-gin-server.md)
     - [go-server](go-server.md)
+    - [graphql-server](graphql-server.md)
     - [haskell](haskell.md)
     - [java-inflector](java-inflector.md)
     - [java-msf4j](java-msf4j.md)
@@ -111,6 +115,7 @@ The following generators are available:
 
 * CONFIG generators:
     - [apache2](apache2.md)
+    - [graphql-schema](graphql-schema.md)
 
 
 

docs/generators/ada-server.md

@@ -1,19 +1,14 @@
 
-CONFIG OPTIONS for ada-server
+---
+id: generator-opts-server-ada-server
+title: Config Options for ada-server
+sidebar_label: ada-server
+---
 
-	sortParamsByRequiredFlag
-	    Sort method arguments to place required parameters before optional parameters. (Default: true)
-
-	ensureUniqueParams
-	    Whether to ensure parameter names are unique in an operation (rename parameters that are not). (Default: true)
-
-	allowUnicodeIdentifiers
-	    boolean, toggles whether unicode identifiers are allowed in names or not, default is false (Default: false)
-
-	prependFormOrBodyParameters
-	    Add form or body parameters to the beginning of the parameter list. (Default: false)
-
-	projectName
-	    GNAT project name (Default: defaultProject)
-
-Back to the [generators list](README.md)
+| Option | Description | Values | Default |
+| ------ | ----------- | ------ | ------- |
+|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
+|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
+|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
+|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|
+|projectName|GNAT project name| |defaultProject|

docs/generators/ada.md

@@ -1,19 +1,14 @@
 
-CONFIG OPTIONS for ada
+---
+id: generator-opts-client-ada
+title: Config Options for ada
+sidebar_label: ada
+---
 
-	sortParamsByRequiredFlag
-	    Sort method arguments to place required parameters before optional parameters. (Default: true)
-
-	ensureUniqueParams
-	    Whether to ensure parameter names are unique in an operation (rename parameters that are not). (Default: true)
-
-	allowUnicodeIdentifiers
-	    boolean, toggles whether unicode identifiers are allowed in names or not, default is false (Default: false)
-
-	prependFormOrBodyParameters
-	    Add form or body parameters to the beginning of the parameter list. (Default: false)
-
-	projectName
-	    GNAT project name (Default: defaultProject)
-
-Back to the [generators list](README.md)
+| Option | Description | Values | Default |
+| ------ | ----------- | ------ | ------- |
+|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
+|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
+|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
+|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|
+|projectName|GNAT project name| |defaultProject|

docs/generators/android.md

@@ -1,57 +1,26 @@
 
-CONFIG OPTIONS for android
+---
+id: generator-opts-client-android
+title: Config Options for android
+sidebar_label: android
+---
 
-	sortParamsByRequiredFlag
-	    Sort method arguments to place required parameters before optional parameters. (Default: true)
-
-	ensureUniqueParams
-	    Whether to ensure parameter names are unique in an operation (rename parameters that are not). (Default: true)
-
-	allowUnicodeIdentifiers
-	    boolean, toggles whether unicode identifiers are allowed in names or not, default is false (Default: false)
-
-	prependFormOrBodyParameters
-	    Add form or body parameters to the beginning of the parameter list. (Default: false)
-
-	modelPackage
-	    package for generated models
-
-	apiPackage
-	    package for generated api classes
-
-	invokerPackage
-	    root package for generated code
-
-	groupId
-	    groupId for use in the generated build.gradle and pom.xml
-
-	artifactId
-	    artifactId for use in the generated build.gradle and pom.xml
-
-	artifactVersion
-	    artifact version for use in the generated build.gradle and pom.xml
-
-	sourceFolder
-	    source folder for generated code
-
-	useAndroidMavenGradlePlugin
-	    A flag to toggle android-maven gradle plugin. (Default: true)
-
-	androidGradleVersion
-	    gradleVersion version for use in the generated build.gradle
-
-	androidSdkVersion
-	    compileSdkVersion version for use in the generated build.gradle
-
-	androidBuildToolsVersion
-	    buildToolsVersion version for use in the generated build.gradle
-
-	serializableModel
-	    boolean - toggle "implements Serializable" for generated models (Default: false)
-
-	library
-	    library template (sub-template) to use
-	        volley - HTTP client: Volley 1.0.19 (default)
-	        httpclient - HTTP client: Apache HttpClient 4.3.6. JSON processing: Gson 2.3.1. IMPORTANT: Android client using HttpClient is not actively maintained and will be depecreated in the next major release.
-
-Back to the [generators list](README.md)
+| Option | Description | Values | Default |
+| ------ | ----------- | ------ | ------- |
+|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
+|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
+|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
+|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|
+|modelPackage|package for generated models| |null|
+|apiPackage|package for generated api classes| |null|
+|invokerPackage|root package for generated code| |null|
+|groupId|groupId for use in the generated build.gradle and pom.xml| |null|
+|artifactId|artifactId for use in the generated build.gradle and pom.xml| |null|
+|artifactVersion|artifact version for use in the generated build.gradle and pom.xml| |null|
+|sourceFolder|source folder for generated code| |null|
+|useAndroidMavenGradlePlugin|A flag to toggle android-maven gradle plugin.| |true|
+|androidGradleVersion|gradleVersion version for use in the generated build.gradle| |null|
+|androidSdkVersion|compileSdkVersion version for use in the generated build.gradle| |null|
+|androidBuildToolsVersion|buildToolsVersion version for use in the generated build.gradle| |null|
+|serializableModel|boolean - toggle "implements Serializable" for generated models| |false|
+|library|library template (sub-template) to use|<dl><dt>**volley**</dt><dd>HTTP client: Volley 1.0.19 (default)</dd><dt>**httpclient**</dt><dd>HTTP client: Apache HttpClient 4.3.6. JSON processing: Gson 2.3.1. IMPORTANT: Android client using HttpClient is not actively maintained and will be depecreated in the next major release.</dd><dl>|null|

docs/generators/apache2.md

@@ -1,19 +1,14 @@
 
-CONFIG OPTIONS for apache2
+---
+id: generator-opts-config-apache2
+title: Config Options for apache2
+sidebar_label: apache2
+---
 
-	sortParamsByRequiredFlag
-	    Sort method arguments to place required parameters before optional parameters. (Default: true)
-
-	ensureUniqueParams
-	    Whether to ensure parameter names are unique in an operation (rename parameters that are not). (Default: true)
-
-	allowUnicodeIdentifiers
-	    boolean, toggles whether unicode identifiers are allowed in names or not, default is false (Default: false)
-
-	prependFormOrBodyParameters
-	    Add form or body parameters to the beginning of the parameter list. (Default: false)
-
-	userInfoPath
-	    Path to the user and group files
-
-Back to the [generators list](README.md)
+| Option | Description | Values | Default |
+| ------ | ----------- | ------ | ------- |
+|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
+|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
+|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
+|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|
+|userInfoPath|Path to the user and group files| |null|

docs/generators/apex.md

@@ -1,28 +1,17 @@
 
-CONFIG OPTIONS for apex
+---
+id: generator-opts-client-apex
+title: Config Options for apex
+sidebar_label: apex
+---
 
-	sortParamsByRequiredFlag
-	    Sort method arguments to place required parameters before optional parameters. (Default: true)
-
-	ensureUniqueParams
-	    Whether to ensure parameter names are unique in an operation (rename parameters that are not). (Default: true)
-
-	allowUnicodeIdentifiers
-	    boolean, toggles whether unicode identifiers are allowed in names or not, default is false (Default: false)
-
-	prependFormOrBodyParameters
-	    Add form or body parameters to the beginning of the parameter list. (Default: false)
-
-	classPrefix
-	    Prefix for generated classes. Set this to avoid overwriting existing classes in your org.
-
-	apiVersion
-	    The Metadata API version number to use for components in this package.
-
-	buildMethod
-	    The build method for this package.
-
-	namedCredential
-	    The named credential name for the HTTP callouts
-
-Back to the [generators list](README.md)
+| Option | Description | Values | Default |
+| ------ | ----------- | ------ | ------- |
+|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
+|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
+|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
+|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|
+|classPrefix|Prefix for generated classes. Set this to avoid overwriting existing classes in your org.| |null|
+|apiVersion|The Metadata API version number to use for components in this package.| |null|
+|buildMethod|The build method for this package.| |null|
+|namedCredential|The named credential name for the HTTP callouts| |null|

docs/generators/aspnetcore.md

@@ -1,34 +1,19 @@
 
-CONFIG OPTIONS for aspnetcore
+---
+id: generator-opts-server-aspnetcore
+title: Config Options for aspnetcore
+sidebar_label: aspnetcore
+---
 
-	packageName
-	    C# package name (convention: Title.Case). (Default: Org.OpenAPITools)
-
-	packageVersion
-	    C# package version. (Default: 1.0.0)
-
-	packageGuid
-	    The GUID that will be associated with the C# project
-
-	sourceFolder
-	    source folder for generated code (Default: src)
-
-	aspnetCoreVersion
-	    ASP.NET Core version: 2.1 (default), 2.0 (deprecated) (Default: 2.1)
-
-	sortParamsByRequiredFlag
-	    Sort method arguments to place required parameters before optional parameters. (Default: true)
-
-	useDateTimeOffset
-	    Use DateTimeOffset to model date-time properties (Default: false)
-
-	useCollection
-	    Deserialize array types to Collection<T> instead of List<T>. (Default: false)
-
-	returnICollection
-	    Return ICollection<T> instead of the concrete type. (Default: false)
-
-	useSwashbuckle
-	    Uses the Swashbuckle.AspNetCore NuGet package for documentation. (Default: true)
-
-Back to the [generators list](README.md)
+| Option | Description | Values | Default |
+| ------ | ----------- | ------ | ------- |
+|packageName|C# package name (convention: Title.Case).| |Org.OpenAPITools|
+|packageVersion|C# package version.| |1.0.0|
+|packageGuid|The GUID that will be associated with the C# project| |null|
+|sourceFolder|source folder for generated code| |src|
+|aspnetCoreVersion|ASP.NET Core version: 2.1 (default), 2.0 (deprecated)| |2.1|
+|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
+|useDateTimeOffset|Use DateTimeOffset to model date-time properties| |false|
+|useCollection|Deserialize array types to Collection&lt;T&gt; instead of List&lt;T&gt;.| |false|
+|returnICollection|Return ICollection&lt;T&gt; instead of the concrete type.| |false|
+|useSwashbuckle|Uses the Swashbuckle.AspNetCore NuGet package for documentation.| |true|

docs/generators/bash.md

@@ -1,40 +1,21 @@
 
-CONFIG OPTIONS for bash
+---
+id: generator-opts-client-bash
+title: Config Options for bash
+sidebar_label: bash
+---
 
-	sortParamsByRequiredFlag
-	    Sort method arguments to place required parameters before optional parameters. (Default: true)
-
-	ensureUniqueParams
-	    Whether to ensure parameter names are unique in an operation (rename parameters that are not). (Default: true)
-
-	allowUnicodeIdentifiers
-	    boolean, toggles whether unicode identifiers are allowed in names or not, default is false (Default: false)
-
-	prependFormOrBodyParameters
-	    Add form or body parameters to the beginning of the parameter list. (Default: false)
-
-	curlOptions
-	    Default cURL options
-
-	processMarkdown
-	    Convert all Markdown Markup into terminal formatting (Default: false)
-
-	scriptName
-	    The name of the script that will be generated (e.g. petstore-cli)
-
-	generateBashCompletion
-	    Whether to generate the Bash completion script (Default: false)
-
-	generateZshCompletion
-	    Whether to generate the Zsh completion script (Default: false)
-
-	hostEnvironmentVariable
-	    Name of environment variable where host can be defined (e.g. PETSTORE_HOST='http://api.openapitools.org:8080')
-
-	basicAuthEnvironmentVariable
-	    Name of environment variable where username and password can be defined (e.g. PETSTORE_CREDS='username:password')
-
-	apiKeyAuthEnvironmentVariable
-	    Name of environment variable where API key can be defined (e.g. PETSTORE_APIKEY='kjhasdGASDa5asdASD') (Default: false)
-
-Back to the [generators list](README.md)
+| Option | Description | Values | Default |
+| ------ | ----------- | ------ | ------- |
+|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
+|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
+|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
+|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|
+|curlOptions|Default cURL options| |null|
+|processMarkdown|Convert all Markdown Markup into terminal formatting| |false|
+|scriptName|The name of the script that will be generated (e.g. petstore-cli)| |null|
+|generateBashCompletion|Whether to generate the Bash completion script| |false|
+|generateZshCompletion|Whether to generate the Zsh completion script| |false|
+|hostEnvironmentVariable|Name of environment variable where host can be defined (e.g. PETSTORE_HOST='http://api.openapitools.org:8080')| |null|
+|basicAuthEnvironmentVariable|Name of environment variable where username and password can be defined (e.g. PETSTORE_CREDS='username:password')| |null|
+|apiKeyAuthEnvironmentVariable|Name of environment variable where API key can be defined (e.g. PETSTORE_APIKEY='kjhasdGASDa5asdASD')| |false|

docs/generators/c.md

@@ -0,0 +1,14 @@
+
+---
+id: generator-opts-client-c
+title: Config Options for c
+sidebar_label: c
+---
+
+| Option | Description | Values | Default |
+| ------ | ----------- | ------ | ------- |
+|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
+|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
+|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
+|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|
+|hideGenerationTimestamp|Hides the generation timestamp when files are generated.| |true|