Skip to content

Spell check the documentation #1113

Closed
@ahcorde

Description

@ahcorde

As part of our spring cleaning, we want to detect spell issues in our documentation and fix it when possible. Here's a potential plan to tackle this issue:

  1. We suggest to start checking out the main branch.
  2. Identify the files that contain documentation. These are typically .md (Markdown) or .md.in (a Markdown file to be generated by CMake).
  3. Install in your system a tool to check for spelling errors (e.g.: aspell in Ubuntu).
  4. Run the spell checks in all the documents. Most of the catches will be false positives due to words like Protobuf, CMake and other words that aren't typically in an English dictionary. Ignore all of these until you catch a real spell problem.
  5. Fix it. Usually these programs recommend a proper word or you can later manually modify the file with the correct English term.
  6. Create a pull request with your fixes. This guide can be helpful. Don't be shy, we'll be kind during the process and help you if you don't have much experience with Gazebo yet or the instructions are not clear enough.

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationenhancementNew feature or requestgood first issueGood for newcomers

Type

No type

Projects

Status

Done

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions