first

previ · previ · commit 8d86b30e7d21 · 2022-12-19T00:49:04.000+01:00
diff --git a/.github/workflows/build_publish.yaml b/.github/workflows/build_publish.yaml
@@ -46,7 +46,8 @@ jobs:
       - name: Install dependencies
         run: npm ci
       - name: Generate REST API docs
-        run: docker run --rm -v "${PWD}:/local" openapitools/openapi-generator-cli generate -i https://raw.githubusercontent.com/CoderBotOrg/backend/develop/coderbot/v1.yml -g markdown -o /local/docs/api_v1
+        run: npm i -g widdershins
+        run: widdershins ../backend/coderbot/v1.yml --lang Python -o docs/api.md https://raw.githubusercontent.com/CoderBotOrg/backend/develop/coderbot/v1.yml -o docs/api.md
       - name: Static HTML export with VitePress
         run: npm run docs:build
       - name: Upload artifact
diff --git a/docs/.vitepress/config.js b/docs/.vitepress/config.js
@@ -8,10 +8,12 @@ export default {
         items: [
           { text: 'Description', link: '/Description' },
           { text: 'Getting Started', link: '/Getting_started' },
+          { text: 'Deployment', link: '/Deployment' },
           { text: 'Hardware Architecture', link: '/Hardware_Architecture' },
           { text: 'Software Architecture', link: '/Software_Architecture' },
-          { text: 'Backend', link: '/Backend' },
+          { text: 'Backend API', link: '/api.md' },
           { text: 'Frontend', link: '/Frontend' },
+          { text: 'Backend', link: '/Backend' },
         ]
       }
     ]
diff --git a/docs/Backend.md b/docs/Backend.md
@@ -8,7 +8,7 @@ The services are all implemented, and served, as REST API exposed by the [connex
 
 ## CoderBot API
 
-See the full specification of the [CoderBot REST API](./api_v1/README.md).
+See the full specification of the [CoderBot REST API](./api.md).
 
 ## Features
 
diff --git a/docs/api.md b/docs/api.md

Original file line number	Diff line number	Diff line change
`@@ -8,10 +8,12 @@ export default {`
`8`	`8`	`items: [`
`9`	`9`	`{ text: 'Description', link: '/Description' },`
`10`	`10`	`{ text: 'Getting Started', link: '/Getting_started' },`
	`11`	`+ { text: 'Deployment', link: '/Deployment' },`
`11`	`12`	`{ text: 'Hardware Architecture', link: '/Hardware_Architecture' },`
`12`	`13`	`{ text: 'Software Architecture', link: '/Software_Architecture' },`
`13`		`- { text: 'Backend', link: '/Backend' },`
	`14`	`+ { text: 'Backend API', link: '/api.md' },`
`14`	`15`	`{ text: 'Frontend', link: '/Frontend' },`
	`16`	`+ { text: 'Backend', link: '/Backend' },`
`15`	`17`	`]`
`16`	`18`	`}`
`17`	`19`	`]`