Skip to content

Add MkDocs documentation with GitHub Pages deployment - #176

Merged
berendkleinhaneveld merged 7 commits into
masterfrom
documentation
Jul 7, 2026
Merged

Add MkDocs documentation with GitHub Pages deployment#176
berendkleinhaneveld merged 7 commits into
masterfrom
documentation

Conversation

@berendkleinhaneveld

Copy link
Copy Markdown
Collaborator
  • Set up MkDocs with Material theme (mkdocs.yml, docs dependency group)
  • Add GitHub Actions workflow for building and deploying to GitHub Pages
  • Write documentation covering getting started, guide, renderers, reference, and examples
  • Add site/ to .gitignore

Resolves #101 .

- Set up MkDocs with Material theme (mkdocs.yml, docs dependency group)
- Add GitHub Actions workflow for building and deploying to GitHub Pages
- Write documentation covering getting started, guide, renderers, reference, and examples
- Add site/ to .gitignore
@berendkleinhaneveld

berendkleinhaneveld commented Jun 18, 2026

Copy link
Copy Markdown
Collaborator Author

After creating this PR I found out that MkDocs is not really maintained anymore, so will have to decide on whether to go with this setup or immediately migrate to a better supported alternative. 🤷

Edit: will deal with finding an alternative when the need arises.

berendkleinhaneveld and others added 6 commits July 7, 2026 19:06
…w features

Document features merged from master: text expressions with {{ }} in
element content, pygfx <text> element support (text/markdown attributes,
child text nodes), keyed list reconciliation behavior, and PySide tree
view drag-and-drop with preserved selection/expansion state. Add the new
landmarks, keyed tree, and tree DnD examples to the example pages.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Document the new PySide text element support (#191): update the
renderer-support note in the template syntax guide, add a Text Content
section to the PySide renderer page, and switch the counter examples to
text interpolation to match examples/pyside/counter.cgx.

Document the --show-code CLI flag and the CGX_DEBUG environment
variable (#175) on the CLI page.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Bump checkout to v7, setup-python to v6, and pin setup-uv to the same
sha (v8.3.0) as ci.yml and benchmark.yml. Bump upload-pages-artifact
and deploy-pages to v5.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@berendkleinhaneveld
berendkleinhaneveld merged commit b46cbd9 into master Jul 7, 2026
8 of 10 checks passed
@berendkleinhaneveld
berendkleinhaneveld deleted the documentation branch July 7, 2026 21:17
berendkleinhaneveld added a commit that referenced this pull request Jul 21, 2026
Features:
- Add pure-Python view API as alternative to cgx templates (#193)
- Support text elements for PySide widgets that display text (#191)

Fixes & internals:
- Fragment parenting overhaul (#162)
- Fix PyInstaller hook for CGX files inside packages (#184)
- Write compiled AST to temp file when CGX_DEBUG is set (#175)

Performance:
- Speed up mount path: cheap arity check, reuse first(), leaner emit (#186)
- Cache Fragment._component_parent() lookups (#187)
- Avoid redundant anchor lookups in Fragment.anchor() and unkeyed v-for (#188)

Documentation:
- Add MkDocs documentation with GitHub Pages deployment (#176)
- Add internals architecture documentation page (#194)
- Add docs badge and links to README (#192)

Tooling & CI:
- Add benchmark suite and per-PR benchmark CI workflow (#185)
- Make benchmark CI guard robust against run-to-run noise (#196)
- Update GitHub actions from Node 20 to Node 24 (#190)
- Migrate from pre-commit to prek (#195)

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
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.

Documentation

1 participant