Improve spelling, wording and style

This commit is contained in:
Manfred Brandl
2018-08-21 10:38:53 +02:00
committed by GitHub
parent 1f5066bde1
commit e35031760d
+12 -9
View File
@@ -62,7 +62,7 @@ Issues that have a big impact or matter most to _new mappers_.
[priority_link]: https://github.com/openstreetmap/iD/issues?q=is%3Aopen+is%3Aissue+label%3Apriority
Red labels are for **bugs**. These are things that we want fixed, but might be a bit more
complicted than the green action items.
complicated than the green action items.
* <sub>[![bug][bug]][bug_link]
[![bug-release-blocker][bug-release-blocker]][bug-release-blocker_link]
@@ -182,6 +182,7 @@ Work in Progress. Don't start work on these, somebody else already did!
[bluesky_link]: https://github.com/openstreetmap/iD/issues?q=is%3Aopen+is%3Aissue+label%3Abluesky
[wip_link]: https://github.com/openstreetmap/iD/issues?q=is%3Aopen+is%3Aissue+label%3Awip
## Verifying Bug Fixes
To verify a bug fix (or test a new feature), use the [master deployment](http://preview.ideditor.com/master/)
@@ -191,6 +192,7 @@ latest code and translation strings.
The deployments on openstreetmap.org and http://preview.ideditor.com/release/ are updated only
with stable releases. Issues that are marked fixed in the tracker may still be present.
## Translating
Translations are managed using the
@@ -243,6 +245,7 @@ These are separate translations for uniformity reasons and because some language
may translate "type" differently in "type of aeroway" and "type of amenity", for
example.
## Adding New Strings for Translation or Updating Existing Strings
iD translates strings with a `t` function - `t('foo.bar')` translate the key
@@ -334,6 +337,7 @@ Test your code and make sure it passes.
2. run `npm install`
3. run `npm test` to see whether your tests pass or fail.
## Building / Installing
You can rebuild iD completely with the command `npm run all`.
@@ -367,12 +371,13 @@ The `iD.js` and `iD.min.js` files in this project are autogenerated - don't edit
3. Commit your changes with an informative commit message
4. [Submit a pull request](https://help.github.com/articles/using-pull-requests) to the `openstreetmap/iD` project.
## Using GitHub and git
If you are new to GitHub or git you can read the [GitHub Guides](https://guides.github.com)
"Understanding the GitHub Flow", "Git Handbook" and "Forking Projects" could be especially interesting to you.
## Step by Step
# Step by Step
Additionally here is a step-by-step workflow example for beginners:
@@ -396,14 +401,14 @@ Additionally here is a step-by-step workflow example for beginners:
10. Your Pull Request will be seen by the maintainers of iD. They can merge it or ask for changes. You can update your Pull Request with Steps 7 and 8, Step 9 is required only once per Pull Request.
## Clean Up
# Clean Up
After your Pull Request gets merged into the main repository
you can clean up by deleting the branch from your GitHub-iD-Clone and your local directory
`git push --delete origin <working-branch-name> ; git branch -d <working-branch-name>`
## Restart with another PR after some while
# Restart with another PR after some while
If you did not use your copy of iD for some while, other Pull Request gets merged and you don't have the latest version of iD. You can replace your master with whatever is in our master. If you have not done so yet: Add the main repo as an "upstream" remote:
@@ -413,10 +418,8 @@ Then change to the master branch and get everything from upstream (the main repo
`git checkout master ; git fetch --all && git reset --hard upstream/master`
# Submitting directly in the Browser
## Submitting directly on GitHub (Documentation, Spell fixes, etc.)
If you want to submit with need of testing, you can do this in GitHub without git.
You also need a GitHub account but you can submit directly from your Browser, see
this [GitHub Help Article](https://help.github.com/articles/editing-files-in-another-user-s-repository/).
If you want to submit Documentation, Spelling improvements, etc. which do not need testing,
you can do this with your browser in GitHub. You also need a GitHub account and this [GitHub Help Article](https://help.github.com/articles/editing-files-in-another-user-s-repository/).
Please don't use this to change Code and create untested Pull Requests.