Skip to content

docs: Add all docs files for torchmeter#25

Merged
Ahzyuan merged 29 commits intov0.1.xfrom
docs/mkdocs
May 7, 2025
Merged

docs: Add all docs files for torchmeter#25
Ahzyuan merged 29 commits intov0.1.xfrom
docs/mkdocs

Conversation

@Ahzyuan
Copy link
Copy Markdown
Member

@Ahzyuan Ahzyuan commented May 7, 2025

This PR adds all docs-related files.

The docs of Torchmeter is built by mkdocs, and adopt a distributed deploying strategy which separates the docs source files, docs assets and docs deployment in different places to facilitate docs renewal and management efficiency.

Ahzyuan added 29 commits April 28, 2025 09:27
- delete the origin `docs/README.md` for no use
- update code example in project README.md
- Change PR title prefix from `doc` to `docs`, and update all corresponding configurations in `pr-title-checker-config.json` and `release-drafter.yml`.
- Replace the branching strategy gif with drawio diagram for better visual experience and less loading time
- Update `.gitignore` to exclude drawio cache files
- Update `setup.cfg` to include `mkdocs-drawio-exporter` as a docs dependency
… files

- Add `cheatsheet.md` with detailed explanations of default configuration, tree level index, tree node attributes, and unit explanations
- Update `demo.ipynb` with reference to new cheatsheet section
- Add `MathJax` support for mathematical equations in documentation
- Update `mkdocs.yml` to include new cheatsheet page and enable `MathJax` scripts
- Update reference link in PR guideline and Issue guideline
- Fix indent error in `torchmeter.core`
- Improve compatibility information display
- Update code snippets and clarify usage instructions
- Embed asciinema demo instead of GIF
- Update links to example notebooks and other resources
- Add license icon in homepage footer
- Delete the unnecessary dependency - `mkdocs-asciinema-player`
- Hide TOC in `thanks_contributors.md`
- Hide navigation and TOC in `welcome_contributors.md`
- Update conventions link in PR title linter configuration
- Update `README` with new contribution content
- Reformat `torchmeter.core`
- Remove unused `default_cfg.yaml` softlink
- Replace `:man_raising_hand:` with emoji in the whole docs
- Replace unrenderable icons with the renderable ones in `other/management.md`
- Update site URL and remote repository URL
- Change alias_type from `symlink` to `redirect`
- Remove `deploy_prefix`
@github-actions github-actions Bot added the PR-title-needs-formatting PR title invalid, should be formated according to the contributing guidelines. label May 7, 2025
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2025

Coverage

Coverage Details on macos under Python 3.8
FileStmtsMissCoverMissing
_stat_numeric.py1130100% 
config.py2801096%330, 367, 509, 515, 579–584
core.py3701396%423–424, 429, 467–468, 529, 671, 736, 799, 863, 1827, 1833, 1838
display.py436698%83, 437–438, 440, 799, 901
engine.py1060100% 
statistic.py4431596%54, 60, 66, 72, 77, 207, 792, 850–855, 868–869
unit.py410100% 
utils.py127199%71
TOTAL19164597% 

Summary (on macos under Python 3.8)

Tests Skipped Failures Errors Time
806 2 💤 0 ❌ 0 🔥 6.912s ⏱️

@Ahzyuan Ahzyuan added docs Update or improve the documentation or README. and removed PR-title-needs-formatting PR title invalid, should be formated according to the contributing guidelines. labels May 7, 2025
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2025

Coverage

Coverage Details on ubuntu under Python 3.8
FileStmtsMissCoverMissing
_stat_numeric.py1130100% 
config.py2801096%330, 367, 509, 515, 579–584
core.py3701396%423–424, 429, 467–468, 529, 671, 736, 799, 863, 1827, 1833, 1838
display.py436698%83, 437–438, 440, 799, 901
engine.py1060100% 
statistic.py4431596%54, 60, 66, 72, 77, 207, 792, 850–855, 868–869
unit.py410100% 
utils.py127199%71
TOTAL19164597% 

Summary (on ubuntu under Python 3.8)

Tests Skipped Failures Errors Time
806 2 💤 0 ❌ 0 🔥 12.362s ⏱️

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2025

Coverage

Coverage Details on windows under Python 3.8
FileStmtsMissCoverMissing
_stat_numeric.py1130100% 
config.py2801096%330, 367, 509, 515, 579–584
core.py3701396%423–424, 429, 467–468, 529, 671, 736, 799, 863, 1827, 1833, 1838
display.py436698%83, 437–438, 440, 799, 901
engine.py1060100% 
statistic.py4431596%54, 60, 66, 72, 77, 207, 792, 850–855, 868–869
unit.py410100% 
utils.py127199%71
TOTAL19164597% 

Summary (on windows under Python 3.8)

Tests Skipped Failures Errors Time
806 2 💤 0 ❌ 0 🔥 12.729s ⏱️

@Ahzyuan Ahzyuan merged commit 08f5f2c into v0.1.x May 7, 2025
19 of 20 checks passed
@Ahzyuan Ahzyuan deleted the docs/mkdocs branch May 7, 2025 07:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Update or improve the documentation or README.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant