From 31bff65d95fed990d1a02996077de778eaa98466 Mon Sep 17 00:00:00 2001
From: Gabriel Mougard <gabriel.mougard@canonical.com>
Date: Mon, 8 May 2023 11:17:01 +0200
Subject: [PATCH] lxddoc: Add examples of output

Signed-off-by: Gabriel Mougard <gabriel.mougard@canonical.com>
---
 .sphinx/lxddoc/lxddoc.txt  | 43 ++++++++++++++++++++++++++++++++++++++
 .sphinx/lxddoc/lxddoc.yaml | 38 +++++++++++++++++++++++++++++++++
 2 files changed, 81 insertions(+)
 create mode 100644 .sphinx/lxddoc/lxddoc.txt
 create mode 100644 .sphinx/lxddoc/lxddoc.yaml

diff --git a/.sphinx/lxddoc/lxddoc.txt b/.sphinx/lxddoc/lxddoc.txt
new file mode 100644
index 000000000000..df24ad2cebc1
--- /dev/null
+++ b/.sphinx/lxddoc/lxddoc.txt
@@ -0,0 +1,43 @@
+---
+orphan: true
+---
+
+```{config:option} scheduler.instance cluster
+:liveupdate: `yes`
+:shortdesc: Possible values are all, manual and group. See Automatic placement of instances for more information.
+:condition: container
+:default: `all`
+:type: integer
+
+ The cluster config keys
+```
+
+```{config:option} user.* cluster
+:shortdesc: Free form user key/value storage (can be used in search).
+:condition: container
+:default: -
+:type: string
+:liveupdate: `yes`
+
+This is the real long desc.
+
+With two paragraphs.
+
+And a list:
+
+- Item
+- Item
+- Item
+
+And a table:
+
+Key                                 | Type      | Scope     | Default                                          | Description
+:--                                 | :---      | :----     | :------                                          | :----------
+`acme.agree_tos`                    | bool      | global    | `false`                                          | Agree to ACME terms of service
+`acme.ca_url`                       | string    | global    | `https://acme-v02.api.letsencrypt.org/directory` | URL to the directory resource of the ACME service
+`acme.domain`                       | string    | global    | -                                                | Domain for which the certificate is issued
+`acme.email`                        | string    | global    | -                                                | Email address used for the account registration
+
+
+```
+
diff --git a/.sphinx/lxddoc/lxddoc.yaml b/.sphinx/lxddoc/lxddoc.yaml
new file mode 100644
index 000000000000..c434ddb7844d
--- /dev/null
+++ b/.sphinx/lxddoc/lxddoc.yaml
@@ -0,0 +1,38 @@
+configs:
+    cluster:
+        - scheduler.instance:
+            condition: container
+            default: '`all`'
+            liveupdate: '`yes`'
+            longdesc: |4-
+
+                 The cluster config keys
+            shortdesc: Possible values are all, manual and group. See Automatic placement of instances for more information.
+            type: integer
+        - user.*:
+            condition: container
+            default: '-'
+            liveupdate: '`yes`'
+            longdesc: |4+
+
+                This is the real long desc.
+
+                With two paragraphs.
+
+                And a list:
+
+                - Item
+                - Item
+                - Item
+
+                And a table:
+
+                Key                                 | Type      | Scope     | Default                                          | Description
+                :--                                 | :---      | :----     | :------                                          | :----------
+                `acme.agree_tos`                    | bool      | global    | `false`                                          | Agree to ACME terms of service
+                `acme.ca_url`                       | string    | global    | `https://acme-v02.api.letsencrypt.org/directory` | URL to the directory resource of the ACME service
+                `acme.domain`                       | string    | global    | -                                                | Domain for which the certificate is issued
+                `acme.email`                        | string    | global    | -                                                | Email address used for the account registration
+
+            shortdesc: Free form user key/value storage (can be used in search).
+            type: string