mirror of
https://github.com/ohmyzsh/ohmyzsh.git
synced 2024-12-26 14:30:12 +08:00
chore: correct style in CONTRIBUTING.md (#11306)
Corrected grammatically incorrect sentences, punctuations and typos for better readability.
This commit is contained in:
parent
49691b58b3
commit
50a526f209
@ -35,13 +35,13 @@ you would make is not already covered.
|
|||||||
Please be so kind as to [search](#use-the-search-luke) for any open issue already covering
|
Please be so kind as to [search](#use-the-search-luke) for any open issue already covering
|
||||||
your problem.
|
your problem.
|
||||||
|
|
||||||
If you find one, comment on it so we can know there are more people experiencing it.
|
If you find one, comment on it, so we know more people are experiencing it.
|
||||||
|
|
||||||
If not, look at the [Troubleshooting](https://github.com/ohmyzsh/ohmyzsh/wiki/Troubleshooting)
|
If not, look at the [Troubleshooting](https://github.com/ohmyzsh/ohmyzsh/wiki/Troubleshooting)
|
||||||
page for instructions on how to gather data to better debug your problem.
|
page for instructions on how to gather data to better debug your problem.
|
||||||
|
|
||||||
Then, you can go ahead and create an issue with as much detail as you can provide.
|
Then, you can go ahead and create an issue with as much detail as you can provide.
|
||||||
It should include the data gathered as indicated above, along with:
|
It should include the data gathered as indicated above, along with the following:
|
||||||
|
|
||||||
1. How to reproduce the problem
|
1. How to reproduce the problem
|
||||||
2. What the correct behavior should be
|
2. What the correct behavior should be
|
||||||
@ -57,7 +57,7 @@ We will do our very best to help you.
|
|||||||
Please be so kind as to [search](#use-the-search-luke) for any open issue already covering
|
Please be so kind as to [search](#use-the-search-luke) for any open issue already covering
|
||||||
your suggestion.
|
your suggestion.
|
||||||
|
|
||||||
If you find one, comment on it so we can know there are more people supporting it.
|
If you find one, comment on it, so we know more people are supporting it.
|
||||||
|
|
||||||
If not, you can go ahead and create an issue. Please copy to anyone relevant (e.g. plugin
|
If not, you can go ahead and create an issue. Please copy to anyone relevant (e.g. plugin
|
||||||
maintainers) by mentioning their GitHub handle (starting with `@`) in your message.
|
maintainers) by mentioning their GitHub handle (starting with `@`) in your message.
|
||||||
@ -84,7 +84,7 @@ your [problem](#you-have-a-problem), and any pending/merged/rejected PR covering
|
|||||||
|
|
||||||
If the solution is already reported, try it out and +1 the pull request if the
|
If the solution is already reported, try it out and +1 the pull request if the
|
||||||
solution works ok. On the other hand, if you think your solution is better, post
|
solution works ok. On the other hand, if you think your solution is better, post
|
||||||
it with a reference to the other one so we can have both solutions to compare.
|
it with reference to the other one so we can have both solutions to compare.
|
||||||
|
|
||||||
If not, then go ahead and submit a PR. Please copy to anyone relevant (e.g. plugin
|
If not, then go ahead and submit a PR. Please copy to anyone relevant (e.g. plugin
|
||||||
maintainers) by mentioning their GitHub handle (starting with `@`) in your message.
|
maintainers) by mentioning their GitHub handle (starting with `@`) in your message.
|
||||||
@ -113,14 +113,14 @@ This has become an issue for two opposing reasons:
|
|||||||
- Some users want to have their personal aliases in Oh My Zsh.
|
- Some users want to have their personal aliases in Oh My Zsh.
|
||||||
- Some users don't want any aliases at all and feel that there are too many.
|
- Some users don't want any aliases at all and feel that there are too many.
|
||||||
|
|
||||||
Because of this, from now on we're requiring that new aliases follow these conditions:
|
Because of this, from now on, we require that new aliases follow these conditions:
|
||||||
|
|
||||||
1. They will be used by many people, not just a few.
|
1. They will be used by many people, not just a few.
|
||||||
2. The aliases will be used many times and for common tasks.
|
2. The aliases will be used many times and for common tasks.
|
||||||
3. Prefer one generic alias over many specific ones.
|
3. Prefer one generic alias over many specific ones.
|
||||||
4. When justifying the need for an alias, talk about workflows where you'll use it,
|
4. When justifying the need for an alias, talk about workflows where you'll use it,
|
||||||
preferably in combination with other aliases.
|
preferably in combination with other aliases.
|
||||||
5. If there exists a command with the same name, look for a different alias name.
|
5. If a command with the same name exists, look for a different alias name.
|
||||||
|
|
||||||
This list is not exhaustive! Please remember that your alias will be in the machines of many people,
|
This list is not exhaustive! Please remember that your alias will be in the machines of many people,
|
||||||
so it should be justified why they should have it.
|
so it should be justified why they should have it.
|
||||||
@ -214,7 +214,7 @@ type(scope)!: subject
|
|||||||
```
|
```
|
||||||
|
|
||||||
- `subject`: a brief description of the changes. This will be displayed in the changelog. If you need
|
- `subject`: a brief description of the changes. This will be displayed in the changelog. If you need
|
||||||
to specify other details you can use the commit body but it won't be visible.
|
to specify other details, you can use the commit body, but it won't be visible.
|
||||||
|
|
||||||
Formatting tricks: the commit subject may contain:
|
Formatting tricks: the commit subject may contain:
|
||||||
|
|
||||||
@ -231,8 +231,8 @@ type(scope)!: subject
|
|||||||
|
|
||||||
### Style
|
### Style
|
||||||
|
|
||||||
Try to keep the first commit line short. This is harder to do using this commit style but try to be
|
Try to keep the first commit line short. It's harder to do using this commit style but try to be
|
||||||
concise and if you need more space, you can use the commit body. Try to make sure that the commit
|
concise, and if you need more space, you can use the commit body. Try to make sure that the commit
|
||||||
subject is clear and precise enough that users will know what changed by just looking at the changelog.
|
subject is clear and precise enough that users will know what changed by just looking at the changelog.
|
||||||
|
|
||||||
----
|
----
|
||||||
|
Loading…
Reference in New Issue
Block a user