Skip to content

Expand documentation and Mermaid examples - #5

Merged
timkpaine merged 1 commit into
mainfrom
tkp/documentation
Oct 18, 2026
Merged

timkpaine merged 1 commit into
mainfrom
tkp/documentation

Conversation

@timkpaine

Copy link
Copy Markdown
Member

Description

Add a first-diagram tutorial, task guides for styling, migration, troubleshooting, and local development, and an explanation of browser rendering and non-HTML output. Organize navigation by Diátaxis mode and expand the configuration reference.

Expand the gallery to 16 diagrams with source listings read from the same files as the rendered examples. Add four rendered reStructuredText examples for captions, references, accessibility, zoom, code blocks, and the Pele alias. Move the documentation homepage to /index.html and document installation from the repository while the implementation is unreleased on PyPI.

Verified 23 Python tests, four Chromium tests covering all 20 rendered examples, warning-free HTML and text builds, all three tutorial stages after a fresh source installation, lint/type checks, and wheel/sdist checks.

Type of Change

  • Bug fix
  • New feature
  • Documentation update
  • Refactor / code cleanup
  • CI / build configuration
  • Other (describe below)

Checklist

  • Linting passes (make lint)
  • Tests pass (make test)
  • New tests added for new functionality
  • Documentation updated (if applicable)
  • Changelog / version bump (not applicable; documentation)

Signed-off-by: Tim Paine <3105306+timkpaine@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown

Test Results

27 tests  +1   27 ✅ +1   3s ⏱️ -2s
 2 suites ±0    0 💤 ±0 
 2 files   ±0    0 ❌ ±0 

Results for commit 59872b7. ± Comparison against base commit 1b79d1b.

@codecov

codecov Bot commented Oct 18, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.77%. Comparing base (1b79d1b) to head (59872b7).

Additional details and impacted files
@@           Coverage Diff           @@
##             main       #5   +/-   ##
=======================================
  Coverage   93.77%   93.77%           
=======================================
  Files           2        2           
  Lines         241      241           
  Branches       37       37           
=======================================
  Hits          226      226           
  Misses          8        8           
  Partials        7        7           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@timkpaine
timkpaine merged commit e89a90e into main Oct 18, 2026
4 checks passed
@timkpaine
timkpaine deleted the tkp/documentation branch October 18, 2026 03:23
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