@redpanda-data/docs-extensions-and-macros 5.38.0 → 5.38.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "https://redpanda.com/schemas/property-overrides.schema.json",
|
|
4
|
+
"title": "Property overrides",
|
|
5
|
+
"description": "Hand-authored corrections and additions applied on top of properties extracted from Redpanda's C++ source. See tools/property-extractor/README.adoc.",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"properties": {
|
|
8
|
+
"properties": {
|
|
9
|
+
"type": "object",
|
|
10
|
+
"description": "Keyed by property key or name (see property_extractor.py's name-fallback lookup). An override key that matches neither creates a phantom stub property — see property_extractor.py's report_phantom_stubs().",
|
|
11
|
+
"additionalProperties": { "$ref": "#/$defs/propertyOverride" }
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"additionalProperties": false,
|
|
15
|
+
"$defs": {
|
|
16
|
+
"propertyOverride": {
|
|
17
|
+
"type": "object",
|
|
18
|
+
"additionalProperties": false,
|
|
19
|
+
"properties": {
|
|
20
|
+
"_comment": {
|
|
21
|
+
"type": "string",
|
|
22
|
+
"description": "Free-text note to whoever edits this entry next. Never read by the generator."
|
|
23
|
+
},
|
|
24
|
+
"description": { "type": "string" },
|
|
25
|
+
"upstream_ref": {
|
|
26
|
+
"type": "string",
|
|
27
|
+
"description": "The upstream issue or PR (against the engineering repo whose defective string this description patches, either the short form 'redpanda-data/streaming-enterprise#12345' or the full URL) that will make this description override redundant once merged and released. A description override is a stopgap, not a fix: set this so the override is born with a retirement path, and remove both the override and this field once the fix ships. Only meaningful alongside 'description' — has no effect on generation or rendering."
|
|
28
|
+
},
|
|
29
|
+
"version": {
|
|
30
|
+
"type": "string",
|
|
31
|
+
"description": "Version the property was introduced in (e.g. 'v23.1.0')."
|
|
32
|
+
},
|
|
33
|
+
"example": {
|
|
34
|
+
"description": "Literal example content, or an example_file/example_yaml reference resolved relative to this overrides file."
|
|
35
|
+
},
|
|
36
|
+
"example_file": { "type": "string" },
|
|
37
|
+
"example_yaml": { "type": "string" },
|
|
38
|
+
"default": {
|
|
39
|
+
"description": "Replaces the extracted default. Prefer leaving this unset — it silently pins a value the extractor would otherwise keep in sync with the C++ source on every release."
|
|
40
|
+
},
|
|
41
|
+
"type": { "type": "string" },
|
|
42
|
+
"config_scope": {
|
|
43
|
+
"enum": ["cluster", "broker", "topic", null],
|
|
44
|
+
"description": "Almost always inferred automatically from defined_in — see property_extractor.py's add_config_scope(). Only set this for an override-created property (defined_in: 'override'), which has no source file to infer from."
|
|
45
|
+
},
|
|
46
|
+
"exclude_from_docs": { "type": "boolean" },
|
|
47
|
+
"category": {
|
|
48
|
+
"type": "string",
|
|
49
|
+
"description": "Documentation grouping. Not inferable for cluster/broker properties; topic properties get a mechanical default from infer_category() that this can still override."
|
|
50
|
+
},
|
|
51
|
+
"accepted_values": {
|
|
52
|
+
"type": "array",
|
|
53
|
+
"description": "Replaces the enum field to filter displayed values (e.g. hiding an internal-only mode).",
|
|
54
|
+
"items": {}
|
|
55
|
+
},
|
|
56
|
+
"is_deprecated": { "type": "boolean" },
|
|
57
|
+
"visibility": { "type": "string" },
|
|
58
|
+
"related_topics": {
|
|
59
|
+
"type": "array",
|
|
60
|
+
"deprecated": true,
|
|
61
|
+
"description": "Deprecated — use see_also. A plain string, or one prefixed 'cloud-only:'/'self-managed-only:' for conditional display. The prefix is free text with no validation; still read for existing entries, normalized alongside see_also by seeAlsoView.js.",
|
|
62
|
+
"items": { "type": "string" }
|
|
63
|
+
},
|
|
64
|
+
"see_also": {
|
|
65
|
+
"type": "array",
|
|
66
|
+
"description": "Related commands or documentation pages, in the docs-data/rpk-overrides.json 'seeAlso' shape. Each item is a plain string (shown everywhere) or an object naming exactly one of cloud_only/self_hosted_only (shown only in that build).",
|
|
67
|
+
"items": {
|
|
68
|
+
"oneOf": [
|
|
69
|
+
{
|
|
70
|
+
"type": "string",
|
|
71
|
+
"description": "xref link or related-topic text, shown in every build."
|
|
72
|
+
},
|
|
73
|
+
{
|
|
74
|
+
"type": "object",
|
|
75
|
+
"description": "Conditional see-also item shown only in the named build.",
|
|
76
|
+
"properties": {
|
|
77
|
+
"content": {
|
|
78
|
+
"type": "string",
|
|
79
|
+
"description": "The xref link or related-topic text."
|
|
80
|
+
},
|
|
81
|
+
"cloud_only": {
|
|
82
|
+
"type": "boolean",
|
|
83
|
+
"description": "If true, only shown in Cloud docs (wrapped with ifdef::env-cloud[])."
|
|
84
|
+
},
|
|
85
|
+
"self_hosted_only": {
|
|
86
|
+
"type": "boolean",
|
|
87
|
+
"description": "If true, only shown in self-hosted docs (wrapped with ifndef::env-cloud[])."
|
|
88
|
+
}
|
|
89
|
+
},
|
|
90
|
+
"required": ["content"],
|
|
91
|
+
"additionalProperties": false,
|
|
92
|
+
"oneOf": [
|
|
93
|
+
{
|
|
94
|
+
"required": ["cloud_only"],
|
|
95
|
+
"not": { "required": ["self_hosted_only"] }
|
|
96
|
+
},
|
|
97
|
+
{
|
|
98
|
+
"required": ["self_hosted_only"],
|
|
99
|
+
"not": { "required": ["cloud_only"] }
|
|
100
|
+
}
|
|
101
|
+
]
|
|
102
|
+
}
|
|
103
|
+
]
|
|
104
|
+
}
|
|
105
|
+
},
|
|
106
|
+
"admonitions": {
|
|
107
|
+
"type": "array",
|
|
108
|
+
"description": "Structured NOTE/TIP/IMPORTANT/WARNING/CAUTION callouts, rendered as Asciidoctor admonition blocks instead of hand-written markup in description. Each entry needs type and text; title is optional. See property_extractor.py's _normalize_admonitions() -- an entry that doesn't match this shape is dropped with a warning, not rejected here, so the schema stays permissive on casing/whitespace that the generator itself normalizes.",
|
|
109
|
+
"items": {
|
|
110
|
+
"type": "object",
|
|
111
|
+
"required": ["type", "text"],
|
|
112
|
+
"properties": {
|
|
113
|
+
"type": {
|
|
114
|
+
"type": "string",
|
|
115
|
+
"description": "Case-insensitive; normalized to uppercase. One of note, tip, important, warning, caution.",
|
|
116
|
+
"enum": ["note", "tip", "important", "warning", "caution",
|
|
117
|
+
"NOTE", "TIP", "IMPORTANT", "WARNING", "CAUTION",
|
|
118
|
+
"Note", "Tip", "Important", "Warning", "Caution"]
|
|
119
|
+
},
|
|
120
|
+
"text": {
|
|
121
|
+
"type": "string",
|
|
122
|
+
"description": "Admonition body. May itself contain AsciiDoc markup."
|
|
123
|
+
},
|
|
124
|
+
"title": {
|
|
125
|
+
"type": "string",
|
|
126
|
+
"description": "Optional admonition title, shown in place of the default type label."
|
|
127
|
+
}
|
|
128
|
+
},
|
|
129
|
+
"additionalProperties": false
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@redpanda-data/docs-extensions-and-macros",
|
|
3
|
-
"version": "5.38.
|
|
3
|
+
"version": "5.38.1",
|
|
4
4
|
"description": "Antora extensions and macros developed for Redpanda documentation.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"antora",
|
|
@@ -106,9 +106,8 @@
|
|
|
106
106
|
"tools",
|
|
107
107
|
"docker-compose",
|
|
108
108
|
"mcp",
|
|
109
|
-
"docs-data
|
|
110
|
-
"docs-data/kapa-source-groups.json"
|
|
111
|
-
"docs-data/kapa-source-groups.schema.json"
|
|
109
|
+
"docs-data/*.schema.json",
|
|
110
|
+
"docs-data/kapa-source-groups.json"
|
|
112
111
|
],
|
|
113
112
|
"license": "ISC",
|
|
114
113
|
"engines": {
|