Skip to content

Conversation

@Ahzyuan
Copy link
Member

@Ahzyuan Ahzyuan commented Jun 22, 2025

Prep Steps

Before we dive in, let's confirm you've unlocked all these steps

  • 🔍 I've checked for duplicate PRs (click to check)
  • 📜 I've followed contribution guidelines
    • ✨ I've linted and formatted my code (how?)
    • 🔧 I've formatted the PR title appropriately (how?)
    • 🎯 I've targeted the master branch (how?)
    • 👐 I've allowed maintainer edits on my branch (how? → See step 6)
  • 🛡️ I've added/updated tests to cover my changes if prossible (how?)
  • 📝 I've added/updated the documentation for any new logic introduced (how?)
  • ⏳ I understand @Ahzyuan has been busy lately and may need time to review. (we appreciate your patience!)

Type of changes

  • 🐞 Bug fix
  • 🌟 New feature
  • 🧪 Tests
  • 🏗 Refactoring
  • ⚡ Performance improvement
  • 📖 Documentation / docstrings
  • ↩️ Revert
  • 🧩 Other

Description

Purpose

This PR is to increase the documentation quality and readability, including the following aspects:

  1. Correct all found typos and links errors
  2. Rewrite or supplement details for obscure instructions
  3. Add rich-format emphasis to key content

Changes:

  • README.md: add emphasis in intros.
  • docs/src/en/cheatsheet.md: clarify details of tree-level-index and tree-node-attributes
  • docs/src/en/contribute/conventions.md: fix mistakes in PR title convention & add emphasis on type prefix choosing as well as the exclamation mark's meanings
  • docs/src/en/contribute/discussions.md/docs/src/en/contribute/issues.md/docs/src/en/contribute/prs.md: enable lazy-load for all imgs
  • docs/src/en/contribute/welcome_contributors.md: enhance the welcoming message for contributors
  • docs/src/en/index.md: sync changes with the repo README
  • docs/src/en/others/management.md: clarify the details of branch strategy
  • examples/demo.ipynb: fix all error outer links

Appendix

Note

The changes will be seen in the dev version of the the document: docs.torchmeter.top/dev

Ahzyuan added 6 commits June 22, 2025 16:08
- Add tip about PR title structure.
- Fix the capitalization error in example
- Emphasize the type prefix choosing and the exclamation mark's meanings
…ment page

- Enhance the welcoming message for contributors
- Clarify the details of branch strategy in the repo management page
@Ahzyuan Ahzyuan self-assigned this Jun 22, 2025
@github-actions github-actions bot added the docs Update or improve the documentation or README. label Jun 22, 2025
@Ahzyuan Ahzyuan merged commit 73846f3 into master Jun 22, 2025
1 check passed
@Ahzyuan Ahzyuan deleted the docs/improve-documentation-20250622 branch June 22, 2025 10:07
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.

2 participants