Skip to content

Refactor doc structure#42

Merged
mballance merged 2 commits intomasterfrom
mballance/doc-refactor
Feb 22, 2026
Merged

Refactor doc structure#42
mballance merged 2 commits intomasterfrom
mballance/doc-refactor

Conversation

@mballance
Copy link
Member

No description provided.

mballance and others added 2 commits February 22, 2026 01:55
Replace the flat, API-centric doc structure with a user-first,
task-oriented layout organized around what users actually do:

New top-level sections
- getting-started/  installation + 5-minute quickstart (CLI-first)
- importing/        Verilator, cocotb-coverage, AVL — each in its own page
- working-with-coverage/  merge, TUI explorer, show commands, compare
- reporting/        HTML report and CI/CD format export
- cicd/             GitHub Actions, GitLab CI, Jenkins — copy-pasteable
- ai-integration/   MCP server (framed around what you can ask, not tool list)
- reference/        Developer content separated from user content
  - python-api/     Full OO API: 25 classes/enums, all autodoc'd
  - formats/        XML, YAML, SQLite schema specs
  - report-formats/ HTML and JSON report format specs

conf.py changes
- Add sphinx.ext.napoleon so Google-style docstrings parse correctly
- Add sphinx_design for tab-set directives in quickstart

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
sphinx_design is needed for tab-set directives added in quickstart.rst.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@mballance mballance merged commit c2d6f6e into master Feb 22, 2026
2 checks passed
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.

1 participant