README.md cleanup without changing meaning

While this README.md is currently clear and well written,
I saw some places for improvement.
This commit is contained in:
John McGehee 2019-06-25 11:49:21 -07:00
parent 7aec8fdf32
commit 7bd2ca8419

View File

@ -18,12 +18,12 @@ the following resources are a great place to start:
## Folder structure ## Folder structure
We support a collection of templates, organized in this way: We support a collection of templates, organized as follows:
- the root folder contains templates in common use, to help people get started - The root folder contains templates in common use, to help people get started
with popular programming languages and technologies. These define a meaningful with popular programming languages and technologies. These define a meaningful
set of rules to help get started, and ensure you are not committing set of rules to help get started, and ensure you are not committing
unimportant files into your repository unimportant files into your repository.
- [`Global`](./Global) contains templates for various editors, tools and - [`Global`](./Global) contains templates for various editors, tools and
operating systems that can be used in different situations. It is recommended operating systems that can be used in different situations. It is recommended
that you either [add these to your global template](https://help.github.com/articles/ignoring-files/#create-a-global-gitignore) that you either [add these to your global template](https://help.github.com/articles/ignoring-files/#create-a-global-gitignore)
@ -63,23 +63,23 @@ include your language, tool, or project, its not because its not awesome.
## Contributing guidelines ## Contributing guidelines
Wed love for you to help us improve this project. To help us keep this collection Wed love for you to help us improve this project. To help us keep this collection
high quality, we request that contributions adhere to the following guidelines. high quality, we request that contributions adhere to the following guidelines:
- **Provide a link to the application or projects homepage**. Unless its - **Provide a link to the application or projects homepage**. Unless its
extremely popular, theres a chance the maintainers dont know about or use extremely popular, theres a chance the maintainers dont know about or use
the language, framework, editor, app, or project your change applies to. the language, framework, editor, app, or project your change applies to.
- **Provide links to documentation** supporting the change youre making. - **Provide links to documentation** supporting the change youre making.
Current, canonical documentation mentioning the files being ignored is best. Cite current, canonical documentation that mentions the ignored files.
If documentation isnt available to support your change, do the best you can If documentation isnt available to support your change, do your best
to explain what the files being ignored are for. to explain why the files should be ignored.
- **Explain why youre making a change**. Even if it seems self-evident, please - **Explain why youre making a change**. Even if it seems self-evident, please
take a sentence or two to tell us why your change or addition should happen. add a sentence or two to tell us why your change or addition should happen.
Its especially helpful to articulate why this change applies to _everyone_ Its especially helpful to articulate why this change applies to _everyone_
who works with the applicable technology, rather than just you or your team. who works with the applicable technology, rather than just you or your team.
- **Please consider the scope of your change**. If your change is specific to a - **Scope your change properly**. If your change is specific to a
certain language or framework, then make sure the change is made to the certain language or framework, then make sure the change is made to the
template for that language or framework, rather than to the template for an template for that language or framework, rather than to the template for an
editor, tool, or operating system. editor, tool, or operating system.
@ -95,15 +95,15 @@ the more likely well be to accept your contribution quickly.
Some templates can change greatly between versions, and if you wish to contribute Some templates can change greatly between versions, and if you wish to contribute
to this repository we need to follow this specific flow: to this repository we need to follow this specific flow:
- the template at the root should be the current supported version - The template at the root should be the current supported version
- the template at the root should not have a version in the filename (i.e. - The template at the root should not have a version in the filename (i.e.
"evergreen") "evergreen")
- previous versions of templates should live under `community/` - Previous versions of templates should live under `community/`
- previous versions of the template should embed the version in the filename, - Previous versions of the template should embed the version in the filename
for readability for readability
This helps ensure users get the latest version (because they'll use whatever is This helps ensure users get the latest version (because they'll use whatever is
at the root) but helps maintainers support older versions still in the wild. at the root) while helping maintainers support older versions still in the wild.
## Specialized templates ## Specialized templates