Skip to content

docs: fix spelling typos in system guides#966

Open
njzjz-bot wants to merge 1 commit intodeepmodeling:masterfrom
njzjz-bothub:docs/fix-spelling-typos
Open

docs: fix spelling typos in system guides#966
njzjz-bot wants to merge 1 commit intodeepmodeling:masterfrom
njzjz-bothub:docs/fix-spelling-typos

Conversation

@njzjz-bot
Copy link
Copy Markdown
Contributor

@njzjz-bot njzjz-bot commented Apr 9, 2026

Problem

  • Several system guide pages contain obvious spelling mistakes.
  • The typos scan also reports issues in sample output files, which should not be edited as documentation typos.

Change

  • Fix spelling mistakes in BondOrderSystem, System, and MultiSystems docs
  • Leave sample output files untouched to avoid false-positive edits

Notes

  • Docs-only change

Authored by OpenClaw (model: gpt-5.4)

Summary by CodeRabbit

Documentation

  • Corrected spelling, grammar, and terminology errors throughout system documentation to improve overall clarity and accuracy. Updates address multiple typographical mistakes, refine phrasing for enhanced consistency, and clarify technical descriptions. These improvements ensure users have access to more reliable and readable guidance for better understanding of system operations, features, and configurations.

- correct obvious spelling mistakes in BondOrderSystem, System, and MultiSystems docs
- avoid touching sample output files that would introduce false-positive edits

Authored by OpenClaw (model: gpt-5.4)
@dosubot dosubot bot added the size:S This PR changes 10-29 lines, ignoring generated files. label Apr 9, 2026
@codspeed-hq
Copy link
Copy Markdown

codspeed-hq bot commented Apr 9, 2026

Merging this PR will not alter performance

⚠️ Unknown Walltime execution environment detected

Using the Walltime instrument on standard Hosted Runners will lead to inconsistent data.

For the most accurate results, we recommend using CodSpeed Macro Runners: bare-metal machines fine-tuned for performance measurement consistency.

✅ 2 untouched benchmarks


Comparing njzjz-bothub:docs/fix-spelling-typos (687d4ec) with master (8579ffc)

Open in CodSpeed

@dosubot dosubot bot added the documentation label Apr 9, 2026
@codecov
Copy link
Copy Markdown

codecov bot commented Apr 9, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 86.70%. Comparing base (8579ffc) to head (687d4ec).

Additional details and impacted files
@@           Coverage Diff           @@
##           master     #966   +/-   ##
=======================================
  Coverage   86.70%   86.70%           
=======================================
  Files          86       86           
  Lines        8039     8039           
=======================================
  Hits         6970     6970           
  Misses       1069     1069           

☔ View full report in Codecov by Sentry.
📢 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.

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 9, 2026

📝 Walkthrough

Walkthrough

Documentation typo and grammar corrections across three system documentation files. Changes include spelling corrections ("hetreocycles" → "heterocycles", "infomation" → "information"), grammar fixes ("wan't" → "want"), and other textual improvements. No functional code or API modifications.

Changes

Cohort / File(s) Summary
Documentation Typo & Grammar Corrections
docs/systems/bond_order_system.md, docs/systems/multi.md, docs/systems/system.md
Spelling corrections ("hetreocycles" → "heterocycles", "infomation" → "information", "remeber" → "remember", "muti" → "multi", "typicall" → "typical", "copys" → "copies", "postion" → "position") and minor grammar/wording improvements across system documentation files.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the main change: fixing spelling typos across system documentation guides.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (1)
docs/systems/system.md (1)

129-129: Polish wording for natural English.

Consider changing “Random 8 Hf atoms” to “8 random Hf atoms” for smoother phrasing.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/systems/system.md` at line 129, Change the phrase "Random 8 Hf atoms" to
"8 random Hf atoms" in the sentence that currently reads "Random 8 Hf atoms in
the system will be replaced by Zr atoms with the atom position unchanged" so the
wording becomes natural English and reads e.g. "8 random Hf atoms in the system
will be replaced by Zr atoms with the atom positions unchanged."
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/systems/multi.md`:
- Line 3: The sentence describing the Class dpdata.MultiSystems has incorrect
subject-verb agreement; change "may contains" to "may contain" in the opening
sentence that mentions reading data from a dir which may contains many files of
different systems, or from a single xyz file that contains different systems
(ref: Class dpdata.MultiSystems).

In `@docs/systems/system.md`:
- Line 111: The prose uses the invalid Python expression tuple(1,2,3); update
the sentence to show valid tuple notation by replacing tuple(1,2,3) with either
(1, 2, 3) or tuple([1, 2, 3]) so readers see correct examples (reference the
original token tuple(1,2,3) and the replacements (1, 2, 3) or tuple([1, 2, 3])).

---

Nitpick comments:
In `@docs/systems/system.md`:
- Line 129: Change the phrase "Random 8 Hf atoms" to "8 random Hf atoms" in the
sentence that currently reads "Random 8 Hf atoms in the system will be replaced
by Zr atoms with the atom position unchanged" so the wording becomes natural
English and reads e.g. "8 random Hf atoms in the system will be replaced by Zr
atoms with the atom positions unchanged."
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 4cc6007a-0d76-4691-9ada-7b2d14d992f2

📥 Commits

Reviewing files that changed from the base of the PR and between 8579ffc and 687d4ec.

📒 Files selected for processing (3)
  • docs/systems/bond_order_system.md
  • docs/systems/multi.md
  • docs/systems/system.md

# `MultiSystems`

The Class {class}`dpdata.MultiSystems` can read data from a dir which may contains many files of different systems, or from single xyz file which contains different systems.
The Class {class}`dpdata.MultiSystems` can read data from a dir which may contains many files of different systems, or from a single xyz file that contains different systems.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix subject-verb agreement in the opening sentence.

Use “may contain” instead of “may contains”.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/systems/multi.md` at line 3, The sentence describing the Class
dpdata.MultiSystems has incorrect subject-verb agreement; change "may contains"
to "may contain" in the opening sentence that mentions reading data from a dir
which may contains many files of different systems, or from a single xyz file
that contains different systems (ref: Class dpdata.MultiSystems).

```

tuple(1,2,3) means don't copy atom configuration in x direction, make 2 copys in y direction, make 3 copys in z direction.
tuple(1,2,3) means don't copy atom configuration in x direction, make 2 copies in y direction, make 3 copies in z direction.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🌐 Web query:

In Python, is tuple(1,2,3) valid syntax? What is the correct way to represent a tuple with values 1, 2, and 3?

💡 Result:

No. tuple(1,2,3) is not valid because the tuple() constructor takes at most one positional argument (an iterable), not three separate values. [1]

Correct ways to represent a tuple containing 1, 2, 3:

  • Tuple literal: t = (1, 2, 3) (also valid: t = 1, 2, 3) [2]
  • Using the constructor with an iterable: t = tuple([1, 2, 3]) (or tuple((1, 2, 3))) [1]

Sources:
[1] Purpose of tuple constructor in python - Stack Overflow (stackoverflow.com)
[2] TupleSyntax - Python Wiki (wiki.python.org)

Citations:


Fix tuple notation in prose to avoid misleading users.

tuple(1,2,3) is not valid Python syntax. Use (1, 2, 3) or tuple([1, 2, 3]) instead.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/systems/system.md` at line 111, The prose uses the invalid Python
expression tuple(1,2,3); update the sentence to show valid tuple notation by
replacing tuple(1,2,3) with either (1, 2, 3) or tuple([1, 2, 3]) so readers see
correct examples (reference the original token tuple(1,2,3) and the replacements
(1, 2, 3) or tuple([1, 2, 3])).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation size:S This PR changes 10-29 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant