{#- This template is rendered per top-level registry namespace. -#} {#- It consists of two variables: -#} {#- - id: The top-level namespace id. -#} {#- - groups: A sequence of all attribute groups under this namespace. -#} {#- This includes deprecated groups. -#} {% import 'stability.j2' as stability %} {% import 'notes.j2' as notes %} {% import 'enum_macros.j2' as enums %} {% import 'attribute_macros.j2' as attrs %} {%- set my_file_name = ctx.id | lower | kebab_case ~ ".md" -%} {{- template.set_file_name(my_file_name) -}} # {{ ctx.id | title_case | acronym }} {% if ctx.groups | length > 1 %}{% for group in ctx.groups | sort(attribute="id") %} {%- set group_name = group.id | split_id | list | reject("eq", "registry") | join(" ") -%} - [{{ group_name | title_case }}](#{{group_name | kebab_case }}-attributes) {% endfor %}{% endif %} {% for group in ctx.groups | sort(attribute="id") %} ## {{ group.id | split_id | list | reject("eq", "registry") | join(" ") | title_case | acronym }} Attributes {{ group.brief }} | Attribute | Type | Description | Examples | Stability | |---|---|---|---|---| {%- for attribute in group.attributes | sort(attribute="name") %} | {{ attrs.name(attribute) }} | {{ attrs.type(attribute) }} | {{ attribute.brief | trim }}{{ notes.add(attribute.note) }} | {{ attrs.examples(attribute) | trim }} | {{ stability.badge(attribute.stability, attribute.deprecated) | trim }} | {%- endfor %} {{ notes.render() }} {% for enum in group.attributes | sort(attribute="name") %} {%- if enum.type is mapping -%}{{ enums.table(enum, notes) }}{% endif %} {%- endfor -%} {%- endfor -%}