Add option to allow not including the examples

[darrelmiller]

The generated examples are not very useful as they don't contain representative values and in some cases the values actually don't match the datatypes so they cause warnings and errors with linting tools. They also considerably bulk up the output document.

Consider this example. It doesn't provide any more information than the schema itself.

      example:
        serialNumber: string
        totalStorageSpace: integer
        deviceGuardLocalSystemAuthorityCredentialGuardState: '@odata.type': microsoft.graph.deviceGuardLocalSystemAuthorityCredentialGuardState	          
        osBuildNumber: string
        operatingSystemProductType: integer

The other consideration is to just stop producing examples completely. If we keep them we should consider actually generating representative sample values.

[xuzhg]

@darrelmiller do you have resource to work it?

[darrelmiller]

@xuzhg Yes, I can work with @irvinesunday on this.

#AB4906

[xuzhg]

@darrelmiller, great, i'd love to review it.

[unchase]

Hi, @xuzhg
When will you release this changes into the nuget package?

[xuzhg]

@unchase, it's out on nuget.org, you can find it at: https://www.nuget.org/packages/Microsoft.OpenApi.OData/1.0.4

Let me know if anything is wrong.

[unchase]

@unchase, it's out on nuget.org, you can find it at: https://www.nuget.org/packages/Microsoft.OpenApi.OData/1.0.4

Let me know if anything is wrong.

Thank you. All is good.