summaryrefslogtreecommitdiffstats
path: root/docs/.templates
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 02:57:58 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 02:57:58 +0000
commitbe1c7e50e1e8809ea56f2c9d472eccd8ffd73a97 (patch)
tree9754ff1ca740f6346cf8483ec915d4054bc5da2d /docs/.templates
parentInitial commit. (diff)
downloadnetdata-upstream/1.44.3.tar.xz
netdata-upstream/1.44.3.zip
Adding upstream version 1.44.3.upstream/1.44.3upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'docs/.templates')
-rw-r--r--docs/.templates/.page-level/_collector-page-template.mdx68
-rw-r--r--docs/.templates/.page-level/_concept-page-template.md30
-rw-r--r--docs/.templates/.page-level/_task-page-template.md41
-rw-r--r--docs/.templates/.page-level/_tutorial-page-template.mdx54
-rw-r--r--docs/.templates/integration/schema.json109
5 files changed, 302 insertions, 0 deletions
diff --git a/docs/.templates/.page-level/_collector-page-template.mdx b/docs/.templates/.page-level/_collector-page-template.mdx
new file mode 100644
index 00000000..fcbe7cec
--- /dev/null
+++ b/docs/.templates/.page-level/_collector-page-template.mdx
@@ -0,0 +1,68 @@
+<!--
+title: $COLLECTOR_NAME monitoring with Netdata
+description: Short summary (will be displayed in search engines)
+custom_edit_url: Edit URL of the source file
+keywords: [keywords, describing, the main topics]
+-->
+
+# Title
+
+import {
+ EnableCollector,
+ CollectorDebug,
+} from '@site/src/components/Collectors/_collector-components.jsx';
+
+Short description of what the collector does on a high level.
+Why should I use this collector?
+
+## Configuring $COLLECTOR_NAME
+
+#### Prerequisites
+
+List all needed prerequisites:
+
+- Prerequisite 1
+- Prerequisite 2
+- Prerequisite 3
+
+<CollectorConfiguration configURL="" moduleName="PLUGIN/COLLECTOR.conf" />
+
+### Example
+
+TODO: Check if we can automatically fetch the [JOBS] section of netdata.conf
+
+## Other configuration information
+
+Explain other configuration options, as needed.
+
+#### Prerequisites
+
+<!-- If there is only one requirement, use a paragraph instead of a single bullet item. Bullets are social animals and only appear in groups of 2 or more :) -->
+
+Optional. List all needed prerequisites:
+
+- Prerequisite 1
+- Prerequisite 2
+- Prerequisite 3
+
+To do x:
+
+1. Step 1 written in active voice
+ ```bash
+ Code sample for step
+ ```
+2. Step 2
+ Result of step 2, for example a system reaction; written in passive voice
+3. Step 3
+
+## Debugging $COLLECTOR_NAME (optional)
+
+<CollectorDebug pluginName="" collectorName="" />
+
+## Metrics and Alerts produced by this collector
+
+| Chart | Metrics | Alert |
+| ---------- | ----------- | ------------------------ |
+| Chart Name | Metric name | [Alert 1](Link to alert) |
+| Chart Name | Metric name | [Alert 2](Link to alert) |
+| Chart Name | Metric name | [Alert 3](Link to alert) |
diff --git a/docs/.templates/.page-level/_concept-page-template.md b/docs/.templates/.page-level/_concept-page-template.md
new file mode 100644
index 00000000..685dd2ff
--- /dev/null
+++ b/docs/.templates/.page-level/_concept-page-template.md
@@ -0,0 +1,30 @@
+<!--
+title: Noun that describes the concept
+description: Short summary (will be displayed in search engines)
+custom_edit_url: Edit URL of the source file
+keywords: [keywords, describing, the main topics]
+-->
+
+# Title
+
+Why should the reader care: “What’s in it for me?”
+
+## Subheading
+
+Ideally, try to explain one core idea per section. Questions that you could keep in mind while writing:
+
+- How does it work?
+- What are the outcomes?
+- What are the positive and negative effects of it?
+- Are there alternatives that provide a similar result?
+
+## Subheading
+
+Add more subheadings and anything else that needs to be explained...
+Remember, if you start to describe about another concept, stop yourself.
+Each concept should be about one concept only.
+
+<!-- Optional -->
+### Related links
+<!-- Here, you could include links to task topic that describe how to implement the thing you discussed in this concept. -->
+- Visit the [related thing documentation](www.related-thing.com) to learn more about related thing.
diff --git a/docs/.templates/.page-level/_task-page-template.md b/docs/.templates/.page-level/_task-page-template.md
new file mode 100644
index 00000000..0f49201e
--- /dev/null
+++ b/docs/.templates/.page-level/_task-page-template.md
@@ -0,0 +1,41 @@
+<!--
+title: Starts with an active verb, like "Create a widget" or "Delete a widget"
+description: Short summary (will be displayed in search engines)
+custom_edit_url: Edit URL of the source file
+keywords: [keywords, describing, the main topics]
+-->
+# Title
+
+Short description of why or when the procedure makes sense.
+
+## Subheading that describes the task
+#### Prerequisites
+<!-- If there is only one requirement, use a paragraph instead of a single bullet item. Bullets are social animals and only appear in groups of 2 or more :) -->
+Optional. List all needed prerequisites:
+- Prerequisite 1
+- Prerequisite 2
+- Prerequisite 3
+
+To do x:
+
+1. Step 1 written in active voice
+ ```bash
+ Code sample for step
+ ```
+2. Step 2
+ Result of step 2, for example a system reaction; written in passive voice
+3. Step 3
+
+## If needed, another task section
+
+See lines 11-24
+
+<!-- Optional -->
+## What's next?
+
+Optional section that explains the next logical steps.
+
+<!-- Optional -->
+## Related links
+
+- Visit the [related thing documentation](www.related-thing.com) to learn more about related thing.
diff --git a/docs/.templates/.page-level/_tutorial-page-template.mdx b/docs/.templates/.page-level/_tutorial-page-template.mdx
new file mode 100644
index 00000000..9f64b5ec
--- /dev/null
+++ b/docs/.templates/.page-level/_tutorial-page-template.mdx
@@ -0,0 +1,54 @@
+<!--
+title: Starts with an active verb, like "Create a widget" or "Delete a widget"
+description: Short summary (will be displayed in search engines)
+custom_edit_url: Edit URL of the source file
+author: "Your Name"
+author_title: "Your title at Netdata"
+author_img: "/img/authors/YourFace.jpg"
+keywords: [keywords, describing, the main topics]
+-->
+
+A paragraph that explains what the tutorial does, why it matters, and the expected outcome.
+
+To achieve goal:
+
+1. [Do the first task](#first-task)
+2. [Do the second task](#second-task)
+
+## Prerequisites
+
+<!-- If there is only one requirement, use a paragraph instead of a single bullet item. Bullets are social animals and only appear in groups of 2 or more :) -->
+
+Optional. List all needed prerequisites:
+
+- Prerequisite 1
+- Prerequisite 2
+- Prerequisite 3
+
+## First task
+
+To do x:
+
+1. Step 1 written in active voice
+ ```bash
+ Code sample for step
+ ```
+2. Step 2
+ Result of step 2, for example a system reaction; written in passive voice
+3. Step 3
+
+## Second task
+
+To do x:
+
+1. Step 1 written in active voice
+ ```bash
+ Code sample for step
+ ```
+2. Step 2
+ Result of step 2, for example a system reaction; written in passive voice
+3. Step 3
+
+## What's next?
+
+Optional section that explains the next logical steps.
diff --git a/docs/.templates/integration/schema.json b/docs/.templates/integration/schema.json
new file mode 100644
index 00000000..5f2b2a85
--- /dev/null
+++ b/docs/.templates/integration/schema.json
@@ -0,0 +1,109 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "type": "object",
+ "title": "Netdata Integrations file",
+ "properties": {
+ "categories": {
+ "type": "object",
+ "description": "A list defining all the available categories for the integrations.",
+ "properties": {
+ "list": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "description": "",
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "ID of the category, can be found in integrations/categories.yaml for every category."
+ },
+ "description": {
+ "type": "string",
+ "description": "Text that will be presented below the category title, or that will be accompanying the category in the UI in any form."
+ },
+ "priority": {
+ "type": "integer",
+ "description": "Priority of the category. A number expressing where the category should be in the menu. Currently, a static number gets assigned to all categories, with a higher priority one for the most-popular flagged categories."
+ },
+ "children": {
+ "type": "array",
+ "description": "an array that recursively has the same elements as the parent.",
+ "items": {
+ "$ref": "#"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "integrations": {
+ "type": "array",
+ "description": "A list of integration elements, combination of metadata.yaml and other sources.",
+ "items": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "A unique string identifier for the integration."
+ },
+ "name": {
+ "type": "string"
+ },
+ "categories": {
+ "type": "array",
+ "description": "an array of categories that the integration belongs to",
+ "items": {
+ "type": "object",
+ "properties": {
+ "category_id": {
+ "type": "string",
+ "description": "The category_ID for this integration. This is the category ID mentioned inside integrations/category.yaml, for the respective category."
+ },
+ "priority": {
+ "type": "integer",
+ "description": "Priority for this specific category. Will control where the integration will be positioned in this category"
+ }
+ }
+ }
+ },
+ "icon": {
+ "type": "string",
+ "description": "path to the icon for this integration."
+ },
+ "keywords": {
+ "type": "array",
+ "description": "An array of terms related to the integration.",
+ "items": {
+ "type": "string"
+ }
+ },
+ "overview": {
+ "type": "string",
+ "description": "The text that will go in the top of the page, in markdown format."
+ },
+ "metrics": {
+ "type": "string",
+ "description": "Metrics section rendered in markdown format."
+ },
+ "alerts": {
+ "type": "string",
+ "description": "Alerts section rendered in markdown format."
+ },
+ "setup": {
+ "type": "string",
+ "description": "Setup section rendered in markdown format."
+ },
+ "troubleshooting": {
+ "type": "string",
+ "description": "troubleshooting section rendered in markdown format."
+ },
+ "related_resources": {
+ "type": "string",
+ "description": "Related Resources section rendered in markdown format."
+ }
+ }
+ }
+ }
+ }
+} \ No newline at end of file