feat: serve json schema in ecalc docs

Current json schema served in docs. This schema will represent
the latest changes on main (bleeding).

Will add support for versioning soon, this is atm. a PoC.

.github/workflows/docs-ci.yml

@@ -32,7 +32,12 @@ jobs:
     - name: Generate CLI reference
       run: |
         cd src
-        poetry run python generate_docs.py > ../docs/docs/about/references/cli_reference.md
+        poetry run python generate_docs.py > ../docs/docs/about/getting_started/cli/cli_reference.md
+
+    - name: Generate JSON Schema
+      run: |
+        cd src
+        poetry run python generate_json_schema.py > ../docs/docs/about/getting_started/yaml/ecalc_json_schema.json
 
     - name: Setup node
       uses: actions/setup-node@v4

.github/workflows/docs-publish.yml

@@ -38,7 +38,12 @@ jobs:
     - name: Generate CLI reference
       run: |
         cd src
-        poetry run python generate_docs.py > ../docs/docs/about/references/cli_reference.md
+        poetry run python generate_docs.py > ../docs/docs/about/getting_started/cli/cli_reference.md
+
+    - name: Generate JSON Schema
+      run: |
+        cd src
+        poetry run python generate_json_schema.py > ../docs/docs/about/getting_started/yaml/ecalc_json_schema.json
 
     - name: Setup node
       uses: actions/setup-node@v4

docs/README.md

@@ -117,7 +117,14 @@ $ npm run serve
 In order to generate the CLI reference documentation, use the following (from `src`):
 ```
 $ cd src
-$ poetry run python generate_docs.py > ../docs/docs/about/references/cli_reference.md
+$ poetry run python generate_docs.py > ../docs/docs/about/getting_started/cli/cli_reference.md
+```
+
+### Generate JSON Schema
+In order to generate the JSON Schema documentation, use the following (from `src`):
+```
+$ cd src
+$ poetry run python generate_json_schema.py > ../docs/docs/about/getting_started/yaml/ecalc_json_schema.json
 ```
 
 Then build the documentation: