This is a global notification. You can write markdown here! Link to official website
Enums, Constants & Unions
Enums
EnumTest
Example enumeration for the SetOfEnumTestTypes type.
EnumEntryOne
This is the first entry in the EnumTest enumeration.
EnumEntryTwo
This is the second entry in the EnumTest enumeration.
EnumEntryThree
This is the third entry in the EnumTest enumeration.
enum
This is an item called with a reserved word.
EnumPropertiesType
Test data for properties with enums that are of differing primitive types
intWithEnumExample Int | An int with enum values Can be1 , 2 , or 3 |
floatWithEnumExample Float | A float with enum values Can be1.0 , 2.0 , or 3.0 Default: 1.0 |
enumOfStringExample String | A string with enum values (undescribed) Can be"dog" , "cat" , or "elephant" Default: dog |
EnumWithDescriptionExample
Enum with agreed upon description annotation.
enumValue1
description 1
enumValue2
description 2
enumValue3
description 3
enumWithoutDescription
enumWithMarkdownDescription
inline-code
should be formatted as an inline code. ObjectTestType should link to the header of the definition ofObjectTestType
on this website -api-docs-smoke-test
. Links should link to the header for the definition ofLinks
ondocs-smoke-test
microsite.
EnumWithGroupsExample
Enum with agreed upon description annotation.
enumValue2
description 2
enumValue7
description 7
enumWithMarkdownDescription
inline-code
should be formatted as an inline code. ObjectTestType should link to the header of the definition ofObjectTestType
on this website -api-docs-smoke-test
. Links should link to the header for the definition ofLinks
ondocs-smoke-test
microsite.enumValue10
description 10
enumValue3
description 3
enumValue5
description 5
enumValue6
description 6
enumValue9
description 9
enumWithoutDescription
enumValue1
description 1
enumValue4
description 4
enumValue8
description 8
Group 1
Group 2
Group 3
Constants
ConstantLikeType
render an enum with one value as a constant.
constantExampleValue
ConstantLikeProperties
Has properties that are constant-like, that is, enums with only one value.
stringConstantLike String | "constantStringValue" a string contant-like property |
intConstantLike Int | 256 an integer contant-like property |
floatConstantLike Float | 3.14 a float contant-like property |
Unions
UnionLikeType
A pattern of inheritance that is to be represented like a union, i.e. this parent type would not be shown with a property list on its own.
kind String | |
nonDiscriminatorProperty String |
UnionLikeSubType1
This specific instance of the union is rendered like a regular type with a property table
kind String | "subtype1" |
nonDiscriminatorProperty String | |
foo String | |
name String |
UnionLikeWithEnumDescriptionPropertiesInSubtype
This pattern has sub-types whose properties are enumerations with descriptions.
Enum with agreed upon description annotation. |
UnionLikeSubTypeWithEnumDescriptionProperties1
The discriminatorValue (value1) of this union like sub stype is defined in EnumWithDescriptionExample
type String | "enumValue1" description 1 |
foo String | |
name String |
UnionLikeSubTypeWithEnumDescriptionProperties2
The discriminatorValue (value2) of this union like sub stype is defined in EnumWithDescriptionExample
type String | "enumValue2" description 2 |
bar String | |
name String |
UnionLikeSubTypeWithEnumDescriptionProperties3
The discriminatorValue (value2) of this union like sub stype is defined in EnumWithDescriptionExample but without a description.
type String | "enumWithoutDescription" Enum with agreed upon description annotation. |
baz String | |
name String |