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
EnumEntryTwo
EnumEntryThree
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 |