OpenAPI specification improvements

[dammitjanet]

Using Code Generators (e.g. NSwag) to generated code classes from the Spec, the enums defined in the schemas are being repeated, because the the enum values are repeated in the schema sections

e.g. the lang enum is used 4 times are generates 4 classes with the same names, this is due to the OpenAPI spec not using reusable component schemas for enumeration values

See the reusable Enums section here

Consider defining the enums as shared where appropriate.