Skip to content

Enhance documentation with mascot branding and Material icons - #16

Open
krypton-byte wants to merge 6 commits into
masterfrom
dev
Open

Enhance documentation with mascot branding and Material icons#16
krypton-byte wants to merge 6 commits into
masterfrom
dev

Conversation

@krypton-byte

Copy link
Copy Markdown
Owner

This pull request introduces several improvements to project documentation and CI configuration. The main changes include enhanced visual branding in the documentation, improved navigation with icons, and simplification of CI workflow caching steps.

Documentation improvements:

  • Added a centered mascot image to the top of the README.md, README.id.md, and README.zh.md files for better visual branding. [1] [2] [3] [4]
  • Updated documentation section headers across multiple files to include Material Design icons, making navigation clearer and more visually appealing. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11]
  • Added frontmatter with icons and introductory text to docs/core-concepts/index.md, docs/getting-started/index.md, and docs/api/index.md for improved structure and discoverability. [1] [2] [3]

CI workflow simplification:

  • Simplified Rust cache steps in .github/workflows/CI.yml and .github/workflows/pr-check.yml by removing redundant workspace-specific cache entries. [1] [2]

Other project configuration:

  • Added a GitHub sponsor username to .github/FUNDING.yml.## Summary

Type of Change

  • feat
  • fix
  • docs
  • refactor
  • chore
  • ci/build
  • breaking change

Checklist

  • PR title follows Conventional Commits (type(scope): summary)
  • Local checks pass (ruff, formatting, stub parity)
  • Docs updated if behavior/API changed
  • Relevant tests added/updated
  • No secrets or generated build artifacts committed

Linked Issues

Notes for Reviewer

- Add mascot.png as logo and favicon in mkdocs.yml
- Copy mascot.png to docs/assets/ for Zensical builds
- Add Material Design icons to all 27 documentation page headings
  (installation, quickstart, architecture, API reference, tutorials,
   operations, reference sections)
- Add mascot.png to README.md header across all language variants
- Add mascot image to docs/index.md landing page
Update submodule from 1489b7da to ed543cba (21 commits) including VoIP
optimizations, media performance improvements, and dependency bumps.
Adapt code to breaking changes: hangup→hangup_local, set_muted now async.
Update Cargo.lock to resolve libsqlite3-sys 0.37→0.38 conflict.
… shortcodes

MkDocs nav section doesn't process markdown extensions like pymdownx.emoji,
so :material-*: shortcodes were rendered as plain text. Switch to the
supported approach: icon front matter in section index.md pages with
navigation.indexes feature enabled.
Embed Context7 widget on all documentation pages to provide
developers with version-specific, up-to-date documentation
and code examples directly from the source.
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