Skip to content

Replace Sphinx with Docusaurus#529

Open
Irozuku wants to merge 105 commits intodevelopfrom
feat/docs-docusaurus
Open

Replace Sphinx with Docusaurus#529
Irozuku wants to merge 105 commits intodevelopfrom
feat/docs-docusaurus

Conversation

@Irozuku
Copy link
Copy Markdown
Collaborator

@Irozuku Irozuku commented Apr 7, 2026

Summary

Migrates the documentation system from Sphinx to Docusaurus, updating the documentation structure, build process, and CI workflows accordingly.


Type of Change

Check all that apply like this [x]:

  • Backend change
  • Frontend change
  • CI / Workflow change
  • Build / Packaging change
  • Bug fix
  • Documentation

Changes (by file)

  • docs/Makefile: Removed Sphinx build configuration.
  • .github/workflows/docs.yaml: Updated workflow to use Node.js and Yarn for building and deploying Docusaurus documentation.
  • babel.config.js: Added configuration required for Docusaurus.
  • package.json (docs): Added Docusaurus dependencies and build scripts.
  • docs/docs/build/dev-setup.md: Added development environment setup guide.
  • docs/docs/build/migrations.md: Added database migrations documentation.
  • docs/docs/build/contributing.md: Added contributing guidelines.
  • docs/docs/build/plugin-development/: Introduced plugin development documentation and structure.
  • docs/docs/build/**/_category_.json: Added sidebar/category metadata for Docusaurus.

Testing (optional)

  • Verify documentation builds successfully using Docusaurus (yarn build).
  • Confirm GitHub Actions workflow deploys the generated site correctly.
  • Review new documentation pages for correctness and navigation structure.

Irozuku added 30 commits March 20, 2026 13:00
Adds docs/scripts/generate_components.py which introspects all 120+
registered DashAI components and writes per-component MDX pages and
per-type index pages under docs/docs/components/. All 31 tests pass.
…escaping, YAML quoting, docstring parser

- Use inspect.isfunction() instead of callable() in _get_methods to prevent Pydantic ModelMetaclass (SCHEMA) from appearing as a method
- Add _format_default() helper that reads 'placeholder' key (DashAI's primary default location) before falling back to 'default'
- Update CATEGORY_CONFIG to include GenerativeModel, GenerativeTask, GlobalExplainer, LocalExplainer; remove dead 'explainer' key
- Add _escape_table_cell() and apply it to all Markdown table rows to prevent pipe characters from breaking table layout
- Quote YAML front matter title and sidebar_label values to handle colons and special characters
- Fix _parse_numpy_docstring summary extraction to stop at section underlines even without a preceding blank line
- Remove unused seen = set() variable from _get_methods
- Update test_render_component_mdx_contains_title to expect quoted YAML title
…ages

- Copy all tutorial image folders (upload_dataset, train_model, predict,
  converter, converter_chain, explorer, generative) to docs/static/img/tutorials/
- Remove docs/static/img/.gitkeep
- Add _category_.json for tutorials (position 2) and plugin-development (position 3)
- Port 6 RST tutorials to MDX: upload-dataset, train-model, predict,
  converter, explorer, generative
- Port 4 RST plugin guides to MDX: overview, structure, develop, upload
- RST dropdowns converted to HTML <details>/<summary> in overview.mdx
- :doc: cross-references converted to relative MDX links
- .. note:: / .. warning:: converted to Docusaurus admonitions
… verified

Fix MDX syntax errors in generated component pages by escaping curly braces
({/}) and angle brackets (</>)  in table cells and method summaries; remove
obsolete Sphinx source/ tree; set onBrokenLinks to 'throw' (build is clean).
All 6 tutorial pages (upload-dataset, train-model, predict, converter,
explorer, generative) now use dashed-box JSX placeholders instead of
broken image tags. Screenshots can be dropped in later.
- Huey runs as a subprocess in development, thread only in PyInstaller bundle
- React frontend served by FastAPI in production, port 3000 in development
Docusaurus handles locale routing automatically; links should not
include the locale prefix.
Irozuku added 25 commits April 2, 2026 17:26
Refines documentation to specify that text classification operates on a single text column and outputs a single categorical label. Updates both English and Spanish descriptions for accuracy and clarity, emphasizing typical NLP applications and model requirements.
@Irozuku Irozuku added documentation Improvements or additions to documentation enhancement New feature or request urgent Needs merge ASAP labels Apr 7, 2026
@Irozuku Irozuku changed the title Feat/docs docusaurus Replace Sphinx with Docusaurus Apr 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request urgent Needs merge ASAP

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant