Skip to content

feat: generate API reference docs from OpenAPI spec #1526

Open
fabiovincenzi wants to merge 5 commits intofinos:mainfrom
fabiovincenzi:swagger-docs-1510
Open

feat: generate API reference docs from OpenAPI spec #1526
fabiovincenzi wants to merge 5 commits intofinos:mainfrom
fabiovincenzi:swagger-docs-1510

Conversation

@fabiovincenzi
Copy link
Copy Markdown
Contributor

@fabiovincenzi fabiovincenzi commented May 8, 2026

This PR is based on #1501

  • Adds scripts/doc-swagger.js that parses dist/swagger.json into MDX pages, following the same pattern as the existing scripts/doc-schema.js
  • Generates one page per API tag (Auth, Config, Health, Home, Push, Repositories, Users) plus an index page
  • Adds "API Reference" section to the website sidebar

Closes #1510

@fabiovincenzi fabiovincenzi requested a review from a team as a code owner May 8, 2026 09:46
@netlify
Copy link
Copy Markdown

netlify Bot commented May 8, 2026

Deploy Preview for endearing-brigadeiros-63f9d0 ready!

Name Link
🔨 Latest commit dbefdf2
🔍 Latest deploy log https://app.netlify.com/projects/endearing-brigadeiros-63f9d0/deploys/69fdb0dede0d9b000840711a
😎 Deploy Preview https://deploy-preview-1526.git-proxy.preview.finos.org
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Comment thread scripts/doc-swagger.js
const propResolved = resolveSchema(prop, spec);
const type = formatType(prop, spec);
const isRequired = required.has(name) ? '**Yes**' : 'No';
const desc = (propResolved?.description || '').replace(/\|/g, '\\|');
Comment thread scripts/doc-swagger.js
for (const param of params) {
const type = formatType(param.schema, spec);
const required = param.required ? '**Yes**' : 'No';
const desc = (param.description || '').replace(/\|/g, '\\|');
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Render generated swagger.json for API documentation

3 participants