[typescript] Generate documentation and examples

[NouemanKHAL]

PR checklist

• Read the contribution guidelines.
• Pull Request title clearly describes the work in the pull request and Pull Request description provides details about how to validate the work. Missing information here may result in delayed response from the community.
• Run the following to build the project and update samples:

  ./mvnw clean package 
  ./bin/generate-samples.sh
  ./bin/utils/export_docs_generators.sh
  

  Commit all changed files.
  This is important, as CI jobs will verify all generator outputs of your HEAD commit as it would merge with master.
  These must match the expectations made by your contribution.
  You may regenerate an individual generator by passing the relevant config(s) as an argument to the script, for example ./bin/generate-samples.sh bin/configs/java*.
  For Windows users, please run the script in Git BASH.
• File the PR against the correct branch: master, 5.1.x, 6.0.x
• If your PR is targeting a particular programming language, @mention the technical committee members, so they are more likely to review the pull request.

[therve]

string.md probably doesn't exist, need to check for basic types.

[therve]

Looks good, some minor improvements.

[NouemanKHAL]

@TiFu @taxpon @sebastianhaas @kenisteward @Vrolijkx @macjohnny @topce @akehir @petejohansonxo @amakhrov

[NouemanKHAL]

I guess the CI is good now, can anyone take a look please?
@TiFu @taxpon @sebastianhaas @kenisteward @Vrolijkx @macjohnny @topce @akehir @petejohansonxo @amakhrov

[TiFu]

Looks good to me - Circleci failure is unrelated.

Thank you for the PR!

[TiFu]

@wing328 TS-TC: Could you please shed some light on the below error? I am getting some workflow error that I can't really pin-point to this PR:
https://github.com/OpenAPITools/openapi-generator/runs/2808884555

CC
@TiFu (2017/07) @taxpon (2017/07) @sebastianhaas (2017/07) @kenisteward (2017/07) @Vrolijkx (2017/09) @macjohnny (2018/01) @topce (2018/10) @akehir (2019/07) @petejohansonxo (2019/11) @amakhrov (2020/02)

1s
Run actions/download-artifact@v2.0.9
Starting download for artifact
Directory structure has been setup for the artifact
Total number of files that will be downloaded: 1
Artifact artifact was downloaded to /home/runner/work/openapi-generator/openapi-generator
Artifact download has finished successfully
0s
Run git config --global core.fileMode false
  git config --global core.fileMode false
  git config --global core.safecrlf false
  git config --global core.autocrlf true
  mkdir -p modules/openapi-generator-cli/target/
  mv artifact/openapi-generator-cli.jar modules/openapi-generator-cli/target/
  ./bin/utils/ensure-up-to-date 
  shell: /usr/bin/bash --noprofile --norc -e -o pipefail {0}
mv: cannot stat 'artifact/openapi-generator-cli.jar': No such file or directory```

[lwj5]

This broke something:

  Exception: null
	at org.openapitools.codegen.DefaultGenerator.processOperation(DefaultGenerator.java:1145)
	at org.openapitools.codegen.DefaultGenerator.processPaths(DefaultGenerator.java:1038)
	at org.openapitools.codegen.DefaultGenerator.generateApis(DefaultGenerator.java:561)
	at org.openapitools.codegen.DefaultGenerator.generate(DefaultGenerator.java:878)
	at org.openapitools.codegen.cmd.Generate.execute(Generate.java:441)
	at org.openapitools.codegen.cmd.OpenApiGeneratorCommand.run(OpenApiGeneratorCommand.java:32)
	at org.openapitools.codegen.OpenAPIGenerator.main(OpenAPIGenerator.java:66)
Caused by: java.lang.NullPointerException
	at org.openapitools.codegen.languages.TypeScriptClientCodegen.toExampleValueRecursive(TypeScriptClientCodegen.java:1230)
	at org.openapitools.codegen.languages.TypeScriptClientCodegen.toExampleValueRecursive(TypeScriptClientCodegen.java:1077)
	at org.openapitools.codegen.languages.TypeScriptClientCodegen.toExampleValue(TypeScriptClientCodegen.java:980)
	at org.openapitools.codegen.languages.TypeScriptClientCodegen.setParameterExampleValue(TypeScriptClientCodegen.java:1464)
	at org.openapitools.codegen.DefaultCodegen.fromRequestBody(DefaultCodegen.java:6238)
	at org.openapitools.codegen.DefaultCodegen.fromOperation(DefaultCodegen.java:3855)
	at org.openapitools.codegen.DefaultGenerator.processOperation(DefaultGenerator.java:1113)
	... 6 more

Here's a dumbed-down, redacted version of my YAML. I cannot post the whole YAML as it's an internal document.

openapi: 3.0.3
info:
  title: title
  description: description
  version: 0.0.1
servers:
  - url: "{scheme}://{address}/{basePath}"
    description: description
    variables:
      scheme:
        default: http
      address:
        default: localhost
      basePath:
        default: v0
components:
  schemas:
    Base:
      type: object
      description: description
      properties:
        base:
          description: description
          type: string
    BasePlus:
      title: title
      allOf:
        - $ref: "#/components/schemas/Base"
        - type: object
          title: title
          description: description
          properties:
            basePlus:
              description: description
              type: string
paths:
  "/test":
    put:
      operationId: test
      summary: description
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BasePlus"
      responses:
        "200":
          description: Test successfully

[TiFu]

Many thanks! Let me revert this in the meantime.

[TiFu]

@NouemanKHAL Could you please review and re-file (sorry!) with a fix for the spec that @lwj5 provided?