Simplify help intro texts

This commit is contained in:
Bryan Housel
2017-11-20 18:12:32 -05:00
committed by Minh Nguyễn
parent 7f1dc5e03c
commit d05c56b914
2 changed files with 24 additions and 30 deletions
+14 -15
View File
@@ -558,34 +558,33 @@ en:
intro: |
# Help
With this [OpenStreetMap](https://www.openstreetmap.org/) editor you can
add and update the free and editable map of the world online with your browser.
Welcome to the iD editor for [OpenStreetMap](https://www.openstreetmap.org/).
With this editor you can update OpenStreetMap right from your web browser.
opendata: |
### Open Data
Edits that you make on this map will be freely available to everyone who uses
OpenStreetMap. They can be visible on every map based on OpenStreetMap.
Your edits can be based on personal knowledge, on-the-ground survey, or
background imagery.
[Copying from commercial sources](https://www.openstreetmap.org/copyright)
like Google Maps is strictly forbidden.
Edits that you make on this map will be visible to everyone who uses
OpenStreetMap. Your edits can be based on personal knowledge, on-the-ground surveying,
or aerial or streetlevel imagery. Copying from commercial sources, like Google Maps,
[is strictly forbidden](https://www.openstreetmap.org/copyright).
beforestart: |
### Before you start
You should be familiar with OpenStreetMap and this editor before you start editing.
The walkthrough will teach you the basics of editing on OpenStreetMap and you will
practice using the editor. It takes about 15 minutes and then you can start editing.
iD contains a builtin walkthrough to teach you the basics of editing OpenStreetMap.
Click "Start the Walkthrough" on this screen to take the tutorial - it takes only
about 15 minutes.
opensource: |
### Open Source
The iD editor is a collaborative project and you use version {version} now.
You can contribute and {translate}
[help translating](https://github.com/openstreetmap/iD/blob/master/CONTRIBUTING.md#translating)
or {bug} [report a bug](https://github.com/openstreetmap/iD/issues).
The source code is available for [contributions on GitHub](https://github.com/openstreetmap/iD).
The iD editor is a collaborative open source project, and you are using version {version} now.
The source code is available [on GitHub](https://github.com/openstreetmap/iD).
You can help us by [translating iD](https://github.com/openstreetmap/iD/blob/master/CONTRIBUTING.md#translating)
or [reporting bugs or suggestions](https://github.com/openstreetmap/iD/issues).
overview:
intro: |
+10 -15
View File
@@ -681,19 +681,19 @@
"title": "Help",
"key": "H",
"help": {
"intro": "# Help\n\nWith this [OpenStreetMap](https://www.openstreetmap.org/) editor you can \nadd and update the free and editable map of the world online with your browser.\n",
"opendata": "### Open Data\n\nEdits that you make on this map will be freely available to everyone who uses\nOpenStreetMap. They can be visible on every map based on OpenStreetMap. \nYour edits can be based on personal knowledge, on-the-ground survey, or\nbackground imagery.\n[Copying from commercial sources](https://www.openstreetmap.org/copyright)\nlike Google Maps is strictly forbidden.\n",
"beforestart": "### Before you start\n\nYou should be familiar with OpenStreetMap and this editor before you start editing.\nThe walkthrough will teach you the basics of editing on OpenStreetMap and you will\npractice using the editor. It takes about 15 minutes and then you can start editing.\n",
"opensource": "### Open Source\n\nThe iD editor is a collaborative project and you use version {version} now.\nYou can contribute and {translate}\n[help translating](https://github.com/openstreetmap/iD/blob/master/CONTRIBUTING.md#translating)\nor {bug} [report a bug](https://github.com/openstreetmap/iD/issues).\nThe source code is available for [contributions on GitHub](https://github.com/openstreetmap/iD).\n"
"intro": "# Help\n\nWelcome to the iD editor for [OpenStreetMap](https://www.openstreetmap.org/).\nWith this editor you can update OpenStreetMap right from your web browser.\n",
"opendata": "### Open Data\n\nEdits that you make on this map will be visible to everyone who uses\nOpenStreetMap. Your edits can be based on personal knowledge, on-the-ground surveying,\nor aerial or streetlevel imagery. Copying from commercial sources, like Google Maps,\n[is strictly forbidden](https://www.openstreetmap.org/copyright).\n",
"beforestart": "### Before you start\n\nYou should be familiar with OpenStreetMap and this editor before you start editing.\niD contains a builtin walkthrough to teach you the basics of editing OpenStreetMap.\nClick \"Start the Walkthrough\" on this screen to take the tutorial - it takes only\nabout 15 minutes.\n",
"opensource": "### Open Source\n\nThe iD editor is a collaborative open source project, and you are using version {version} now.\nThe source code is available [on GitHub](https://github.com/openstreetmap/iD).\n\nYou can help us by [translating iD](https://github.com/openstreetmap/iD/blob/master/CONTRIBUTING.md#translating)\nor [reporting bugs or suggestions](https://github.com/openstreetmap/iD/issues).\n"
},
"overview": {
"intro": "# Overview\n\nThis help will repeat and extend information from the walkthrough, which\nyou should have done by now.\n",
"features": "### Features\n\nIn OpenStreetMap we use the word *feature* to describe things that appear on the map.\nAnything in the real world can be mapped as a feature on OpenStreetMap.\nFeatures are represented on the map using *points*, *lines*, or *areas*.\nPoints are sometimes called nodes. Lines and areas are a connected line\nof nodes and are sometimes called ways.\n",
"screen": "### Screen\n\nThis help is on top of the map area which shows background imagery\nand features on top of it. Here you can edit where the features are.\nOn the left side is the *feature editor*, there you can edit feature's type\nand attributes and also {search} search for features and feature's type.\n",
"navigation": "### Navigation\n\nYou can drag the map by pressing and holding the left mouse button\nwhile moving the mouse around. This is also called panning. \nYou can also use the arrow keys on your keyboard, using the keys\nwhile holding 'Ctrl' will move the map for one screenful.\nYou can zoom in or out by scrolling with the mouse wheel or trackpad,\nor by clicking the {plus} / {minus} buttons on the top-right-hand\nof the map, holding 'Ctrl' while clicking will zoom a lot.\n"
"navigation": "### Navigation\n\nYou can drag the map by pressing and holding the left mouse button\nwhile moving the mouse around. This is also called panning.\nYou can also use the arrow keys on your keyboard, using the keys\nwhile holding 'Ctrl' will move the map for one screenful.\nYou can zoom in or out by scrolling with the mouse wheel or trackpad,\nor by clicking the {plus} / {minus} buttons on the top-right-hand\nof the map, holding 'Ctrl' while clicking will zoom a lot.\n"
},
"editing": {
"intro": "# Editing & Saving\n\nTo select a feature you want to edit, click on it on the map\nor search for it by name in the feature editor. \nSelected features are drawn with a pulsing glow and in the\nfeature editor the feature's type and attributes are shown.\nIf you right-click on it, the editing menu appears.\n",
"intro": "# Editing & Saving\n\nTo select a feature you want to edit, click on it on the map\nor search for it by name in the feature editor.\nSelected features are drawn with a pulsing glow and in the\nfeature editor the feature's type and attributes are shown.\nIf you right-click on it, the editing menu appears.\n",
"multiselect": "### Multiselect\nTo select multiple features, hold down the 'Shift' key.\nThen either click on the features you want to select,\nor click, hold and move the mouse on the map to draw\na contour around those features.\nAll the points inside the lasso area will be selected.\n",
"edit": "### Edit\n\nWhen you make changes like editing roads, building, and places\nthese are stored locally until you save them to the server.\nDon't worry if you make a mistake - you can undo changes\nby clicking the {undo} 'Undo' button, and redo changes\nby clicking the {redo} 'Redo' button.\n",
"save": "### Save\n\nClick `Save` to finish a group of edits - for instance, if you've completed\nan area of town and would like to start on a new area. You'll have a chance\nto review what you've done, and the editor supplies helpful suggestions\nand warnings if something doesn't seem right about the changes.\n",
@@ -715,7 +715,7 @@
},
"buildings": {
"intro": "# Buildings & Areas\n\nOpenStreetMap is the world's largest database of buildings.\nYou can improve this database. Buildings are the most used type\nof areas, others are residential areas, farmland, forests, lakes, or ponds.\nWhat you can do with buildings applies to most types of areas.\n",
"select": "### Selecting \n\nYou can select a building by clicking on its border. the pulsing glow will\nwill become visible, all nodes will be shown as circles and the\nfeature editor on the left will show the type of the building and \nattributes like name, levels, and address.\n",
"select": "### Selecting\n\nYou can select a building by clicking on its border. the pulsing glow will\nwill become visible, all nodes will be shown as circles and the\nfeature editor on the left will show the type of the building and\nattributes like name, levels, and address.\n",
"modify": "### Modifying\n\nSometimes buildings are incorrectly placed or have incorrect tags.\nTo move an entire building, select it and press the `M` shortcut key,\nor right-click it and select the {move} 'Move' tool. Move your\nmouse to shift the building, and click when it's correctly placed.\n\nTo fix the specific shape of a building, click and drag the nodes that form\nits border into better places.\n",
"create": "### Creating\n\nOne of the main questions around adding buildings to the map is that\nOpenStreetMap records buildings both as shapes and points. The rule of thumb\nis to _map a building as a shape whenever possible_, and map companies, homes,\namenities, and other things that operate out of buildings as points placed\nwithin the building shape.\n\nStart drawing a building as a shape by clicking the {area} Area button in the top\nleft of the map, and end it either by pressing 'Return' on your keyboard\nor clicking on the first node drawn or clicking again on the last node drawn\nto close the shape.\n\nThen you assign the type of the building to the outline with the feature editor.\nMost buildings are houses, if you're not sure choose the generic Building type.\n",
"delete": "### Deleting\n\nIf a building is entirely incorrect - you can see that it doesn't exist in satellite\nimagery and ideally have confirmed locally that it's not present - you can delete\nit, which removes it from the map. Be cautious when deleting features -\nlike any other edit, the results are seen by everyone and satellite imagery\nis often out of date, so the building could simply be newly built.\n\nYou can delete a building by clicking on it to select it, then pressing the 'Delete'\nkey, or right-clicking it and then using the {delete} 'Delete' tool.\n"
@@ -729,7 +729,7 @@
"feature_editor": {
"intro": "# Feature Editor\n\nThe feature editor is the section on the left side of the page that allows you to\nedit the details of the selected feature.\n",
"select": "### Selecting a Feature Type\n\nAfter you add a point, line, or area, you can choose what type of feature it\nis, like whether it's a highway or residential road, supermarket or cafe.\nThe feature editor will display buttons for common feature types, and you can\nfind others by typing what you're looking for in the search box.\n\nClick the 'i' in the top-right-hand corner of a feature type button to\nlearn more about it. Click a button to choose that type.\n",
"fields": "### Fields\n\nAfter you choose a feature type, or when you select a feature that already\nhas a type assigned, the feature editor will display fields with details about\nthe feature like its name or speed limit for a road or levels and address for a building. \n\nBelow the fields you see, you can click the `Add field` dropdown to add\nother details, like a Wikipedia link, wheelchair access, and more.\n",
"fields": "### Fields\n\nAfter you choose a feature type, or when you select a feature that already\nhas a type assigned, the feature editor will display fields with details about\nthe feature like its name or speed limit for a road or levels and address for a building.\n\nBelow the fields you see, you can click the `Add field` dropdown to add\nother details, like a Wikipedia link, wheelchair access, and more.\n",
"tags": "### Tags\n\nBelow that you see the tags which are actually stored in OpenStreetMap.\nIf you cannot find the feature's type with the feature editor or you\ncannot add required fields, then you can add additional tags with the `+` button.\n[Taginfo](https://taginfo.openstreetmap.org/) is a great resource to learn more\nabout popular tag combinations.\n",
"undo": "### Undo & Redo\n\nChanges you make in the feature editor are automatically applied.\nYou can undo them at any time by clicking the {undo} 'Undo' button and redo\nchanges by clicking the {redo} 'Redo' button.\n"
},
@@ -738,18 +738,13 @@
"background": "### Background\n\nBy default a [Bing Maps](https://www.bing.com/maps/) satellite layer is\npresented in the editor, but as you pan and zoom the map to new geographical\nareas, new sources from the [Open Imagery Network](https://openimagerynetwork.github.io/)\nwill become available.\n",
"offset": "### Offset\n\nImagery is sometimes offset from the map data because of a mistake on the\nimagery provider's side. If you see a lot of roads shifted from the background,\ndon't immediately move them all to match the background. Instead you can adjust\nthe imagery so that it matches the existing data by clicking 'Fix alignment' at\nthe bottom of the Background Settings.\n"
},
"iconstools": {
"icons": "# Icons & Tools\n\nThe icons used in this editor are made to be easily understandable\nand all give you more information with mouse-over.\nHere icons are often used.\n\n### Feature editor\n{search} Search features\n{apply} Apply\n{close} Close\n\n### Top row\n{point} 'Add point' mode\n{line} 'Add line' mode\n{area} 'Add area' mode\n{undo} Undo changes\n{redo} Redo changes\n{save} Save changes\n\n### Right column\n{plus} Zoom in\n{minus} Zoom out\n{geolocate} Show my location\n{layers} Background settings\n{data} Map data\n{help} Help\n\n### Bottom row\n{bug} Report a bug\n{translate} Help translate\n",
"tools": "## Tools in the Editing Menu\n\nWith right-click on features you can use these tools.\n\n{move} Move\n{rotate} Rotate\n{reflect_long} Reflect at long axis\n{reflect_short} Reflect at short axis\n{continue} Continue line\n{reverse} Reverse direction\n{straighten} Straighten line\n{merge} Merge selected features\n{split} Split in two\n{disconnect} Disconnect\n{circularize} Circularize\n{orthogonalize} Square corners\n{delete} Delete\n",
"reserved": "### Reserved for later use are:\n{forward} Forward\n{backward} Backward\n{up} Up\n{down} Down\n{fullscreen} Full screen\n{collapsescreen} Collapse screen\n{relation} Relation\n{vertex} Vertex\n{copy} Copy\n{paste} Paste\n{load} Load\n{simplify} Simplify\n{smooth} Smooth\n{alert} Alert\n{inspect} Inspect\n{nearby} Nearby\n{avatar} Avatar\n{outlink} Share\n"
},
"relations": {
"intro": "# Relations & Members\n\nA *relation* is a special type of feature in OpenStreetMap that groups together other\nfeatures, called *members* of the relation. Every member of a relation can have a\n*role* for the relation. At the bottom of the feature editor, you can see which\nrelations a feature is a member of, and the click on a relation there will select it.\nWhen the relation is selected, you can see all of its members highlighted on the map\nand listed in the feature editor together with their role for the relation.\n",
"types": "### Common Types\n\nThe most common type of relation is the *multipolygon*,\nwhich groups together several areas to define a complex area, which may\nconsist of several pieces or has holes in it like a donut.\nAnother type of relation is the *Turn restriction* which groups together two\nroads segments at a crossing to disable turning options.\n\nTwo other types of relations are *route relations*, which group together\nsections of road that belong to a specific highway, bus route, or hiking route,\nand *boundaries*, which group together sections of boundary lines which may be\nroads, rivers, or plot boundaries at the same time.\n",
"multipolygons": "### Multipolygons\n\nDraw two or more areas and select them. Then press either press\nthe `C` shortcut key or right-click one of the selected areas and \nselect the {merge} 'Merge' tool. This will create a new multipolygon\nrelation with all selected areas as members. The areas will have the role\nouter except When an area is inside another area it will have the role inner\nand become the hole in the outer area.\n",
"multipolygons": "### Multipolygons\n\nDraw two or more areas and select them. Then press either press\nthe `C` shortcut key or right-click one of the selected areas and\nselect the {merge} 'Merge' tool. This will create a new multipolygon\nrelation with all selected areas as members. The areas will have the role\nouter except When an area is inside another area it will have the role inner\nand become the hole in the outer area.\n",
"turnrestrictions": "### Turn restrictions\n\nSelect the crossing node of two or more roads. In the feature editor\nyou will see the roads connected to the crossing below 'Turn Restrictions'.\nThere you can select a road and disable U-turn and turns into every other road.\nThis will create a turn restriction relation with both roads and the\ncrossing as members with roles from, to, and via.\n",
"maintain": "### Maintaining\n\nFor the most part, iD will take care of maintaining relations automatically\nwhile you edit. The main thing you should be aware of is that if you delete a\nsection of road to redraw it more accurately, you should make sure that the\nnew section is a member of the same relations as the original.\n",
"edit": "### Editing Relations\n\nTo add a feature to a relation, select the feature, click the `+` button\nin the 'All relations' section of the feature editor, and select or type\nthe name of the relation.\n\nTo create a new relation, select the first feature that should be a member,\nclick the `+` button in the 'All relations' section, and select 'New relation...'.\n\nTo remove a feature from a relation, select the feature and click the {delete} \n'Delete' button next to the relation you want to remove it from.\n"
"edit": "### Editing Relations\n\nTo add a feature to a relation, select the feature, click the `+` button\nin the 'All relations' section of the feature editor, and select or type\nthe name of the relation.\n\nTo create a new relation, select the first feature that should be a member,\nclick the `+` button in the 'All relations' section, and select 'New relation...'.\n\nTo remove a feature from a relation, select the feature and click the {delete}\n'Delete' button next to the relation you want to remove it from.\n"
}
},
"intro": {