Browse Source

README.md cleanup without changing meaning

While this README.md is currently clear and well written,
I saw some places for improvement.
pull/3096/head
John McGehee 5 years ago
parent
commit
7bd2ca8419
1 changed files with 14 additions and 14 deletions
  1. 14
    14
      README.md

+ 14
- 14
README.md View File

@@ -18,12 +18,12 @@ the following resources are a great place to start:

## 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
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
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)
@@ -63,23 +63,23 @@ include your language, tool, or project, it’s not because it’s not awesome.
## Contributing guidelines

We’d 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 project’s homepage**. Unless it’s
extremely popular, there’s a chance the maintainers don’t know about or use
the language, framework, editor, app, or project your change applies to.

- **Provide links to documentation** supporting the change you’re making.
Current, canonical documentation mentioning the files being ignored is best.
If documentation isn’t available to support your change, do the best you can
to explain what the files being ignored are for.
Cite current, canonical documentation that mentions the ignored files.
If documentation isn’t available to support your change, do your best
to explain why the files should be ignored.

- **Explain why you’re 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.
It’s especially helpful to articulate why this change applies to _everyone_
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
template for that language or framework, rather than to the template for an
editor, tool, or operating system.
@@ -95,15 +95,15 @@ the more likely we’ll be to accept your contribution quickly.
Some templates can change greatly between versions, and if you wish to contribute
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 not have a version in the filename (i.e.
- 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.
"evergreen")
- previous versions of templates should live under `community/`
- previous versions of the template should embed the version in the filename,
- Previous versions of templates should live under `community/`
- Previous versions of the template should embed the version in the filename
for readability

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


Loading…
Cancel
Save