codeant-ai-for-open-source[bot] commented on PR #36805:
URL: https://github.com/apache/superset/pull/36805#issuecomment-3685453643
## **Sequence Diagram**
The PR adds a docs-generation pipeline that extracts DATABASE_DOCS from
superset/db_engine_specs/lib.py (preferably by running it under Flask),
produces a databases.json, generates per-database MDX pages and an index, and
optionally updates README logos. This diagram shows the main success path and
fallback extraction used by the new Node script.
```mermaid
sequenceDiagram
participant Dev/CI
participant Script as generate-database-docs.mjs
participant Python as lib.py (Flask)
participant FS as Filesystem
participant Docusaurus
Dev/CI->>Script: run generate:database-docs
Script->>Python: try run generate_yaml_docs() under Flask (full
diagnostics)
alt full run succeeds
Python-->>Script: JSON docs with diagnostics
else fallback
Script->>Python: extract DATABASE_DOCS and best-effort diagnostics
Python-->>Script: partial JSON docs
end
Script->>FS: write src/data/databases.json
Script->>FS: generate MDX pages + index (docs/databases/*.mdx,
_category_.json)
Script->>FS: (opt) update README logos if requested
Dev/CI->>Docusaurus: build/start (reads generated data & MDX)
Docusaurus-->>Dev/CI: served documentation pages (databases overview +
details)
```
---
*Generated by [CodeAnt AI](https://codeant.ai)*
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
