Changes between Version 112 and Version 113 of Introduction


Ignore:
Timestamp:
2016-11-05T20:11:02+01:00 (9 years ago)
Author:
Klumbumbus
Comment:

grammar, shorten links, more minor adjustments

Legend:

Unmodified
Added
Removed
Modified

  • Introduction

    v112 v113  
    99 [[Image(source:trunk/images/data/way.png,middle,inline,link=)]] Way:: A way is a line connecting multiple nodes. Way, therefore, is a general term for series of joined nodes, not just for roads or ways in reality.
    1010
    11  [[Image(source:trunk/images/data/relation.png,middle,inline,link=)]] Relation:: A relation is an ordered sequence of ways and nodes, a logical container used to group elements. [https://taginfo.openstreetmap.org/reports/database_statistics Only 1% of the data is modelled using relations].
     11 [[Image(source:trunk/images/data/relation.png,middle,inline,link=)]] Relation:: A relation is an ordered sequence of ways and nodes, a logical container used to group elements. Only [https://taginfo.openstreetmap.org/reports/database_statistics 1% of the data] is modelled using relations.
    1212
    1313 [[Image(source:trunk/images/data/closedway.png,middle,inline,link=)]] Area:: An area is a way whose ends are connected.
    1414
    15  [[Image(source:trunk/images/dialogs/propertiesdialog.svg,middle,16,inline,link=)]] Tag:: Tags describe what each node or way represents. Tags are organized into "keys" and "values." Keys are basically larger categories, such as "Highway" or "Land Use," while values are specific features, such as "Primary Road" or "Residential Street," and "Residential" or "Retail" land use.
     15 [[Image(source:trunk/images/dialogs/propertiesdialog.svg,middle,16,inline,link=)]] Tag:: Tags describe what each node, way or relation represents. Tags are organized into "keys" and "values." Keys are basically larger categories, such as "Highway" or "Land Use," while values are specific features, such as "Primary Road" or "Residential Street," and "Residential" or "Retail" land use.
    1616
    17 If a road or track or path is curved, the curve is approximated using a number of nodes within a way, and short lines connecting them. If a way has a direction, that is indicated partly by using tags. For example, "oneway=yes" is a road that goes only in one direction. Other tags refer to being on the left and right of the direction of way along the way.
     17If a road, track or path is curved, the curve is approximated using a number of nodes within a way, and short lines connecting them. If a way has a direction, that is indicated partly by using tags. For example, "oneway=yes" is a road that goes only in one direction. Other tags refer to being on the left and right of the direction of way along the way.
    1818
    1919== Launch JOSM ==
    20 JOSM is a Java program, [wiki:Download#Recommendedoptions can be run from Download page].
     20JOSM is a Java program, can be run from the [wiki:Download#Recommendedoptions Download page].
    2121
    2222== Your first edit with JOSM ==
    … …  
    3636[[Image(download-data.gif,600,inline,link=)]]
    3737
    38 ''"Slippy Map" tab will be displayed, a map of the world. But you need to select smaller area for your edit, not entire globe (thus you will see "Download are too large" message).
     38''The Download window will be displayed which contains a map of the world. You need to select a small area for your edit, not the entire globe (thus you will see the "Download area too large" message).
    3939
    4040''To move around the map and select the specific area you want to download, there are several tools:
    4141* ''Click with the right mouse button to drag the map
    4242* ''Use the scroll wheel to zoom in and out
    43 * ''click with the left mouse button to define an area. 
     43* ''Click with the left mouse button and move the mouse to define an area.
    4444
    45 ''After "Download are too large" error disappeared and you selected a region, click "Download" to fetch the data from main server.''
     45''After the "Download area too large" error disappeared and you selected a region, click "Download" to fetch the data from the main server.''
    4646
    4747=== Enable Aerial imagery ===
    … …  
    5959=== Editing in JOSM ===
    6060
    61 JOSM is an offline editor which means everything you do won't be visible for anyone else until uploading it to the server. This makes it possible to experiment and repeatedly moving, tagging, adding and deleting elements without breaking anything. Subsequent actions on a single element will go into the database as a single modification when uploaded.
     61JOSM is an offline editor which means everything you do won't be visible for anyone else until you uploade it to the server. This makes it possible to experiment and repeatedly moving, tagging, adding and deleting elements without breaking anything. Subsequent actions on a single element will go into the database as a single modification when uploaded.
    6262
    6363=== Adding a Node or a Way ===
    64 The first step of actual editing is to [wiki:Help/Action/Draw add a node] or way to the OSM data. You can add standalone nodes or you can add nodes to ways, especially where there is [Help/Action/Draw#Commonnodeswithanotherway a junction between two ways].
     64The first step of actual editing is to [wiki:Help/Action/Draw add a node] or way to the OSM data. You can add standalone nodes or you can add nodes to ways, especially where there is a [Help/Action/Draw#Commonnodeswithanotherway junction between two ways].
    6565
    66 To add a node, highlight the "Node" button, either by clicking the 3rd button in the left menu bar [[Image(source:trunk/images/mapmode/node/autonode.png,20,middle,link=)]]
    67 , or by hitting the "A" key on the keyboard (the 2nd button should then be highlighted). Then, move the mouse cursor over where you want the node, over a way or over your GPS track (if you uploaded one) and left click wherever you want a node. A red dot (a selected node) should appear and a rubber-line span from that dot to the mouse cursor. If you create subsequent nodes, the earlier nodes will be shown as yellow dots.
     66To add a node, highlight the "Node" button, either by clicking the [[Image(source:trunk/images/mapmode/node/autonode.png,20,middle,link=)]] button in the left menu bar, or by hitting the "A" key on the keyboard (the button should then be highlighted). Then move the mouse cursor over where you want the node, over a way or over your GPS track (if you uploaded one) and left click wherever you want to place the node. A red dot (a selected node) should appear and a rubber-line spans from that node to the mouse cursor. If you create subsequent nodes, the earlier nodes will be shown as yellow nodes.
    6867
    6968A series of joined nodes forms a way.
    7069
    7170=== Adding Tags ===
    72 Ways or nodes on their own are not of much use unless they are ''tagged'' [wiki:Help/Concepts/Object#Tags to say what they represent]. The [osmwiki:Map_Features Map Features] page shows some popular tags, this page will never complete about all tags.
     71Ways or nodes on their own are not of much use unless they are ''[wiki:Help/Concepts/Object#Tags tagged]'' to say what they represent. The [osmwiki:Map_Features Map Features] page shows some popular tags, this page will never be complete about all tags.
    7372
    7473The first step in adding tags is to be sure the [wiki:Help/Dialog/TagsMembership Tags/Membership Dialog] is open on the right hand side of JOSM. The [[Image(source:trunk/images/dialogs/propertiesdialog.svg,20,middle,link=)]] button on the left should be highlighted. If it is not highlighted, click on it or hit `Alt+Shift+P`. You will see the Tags/Membership Dialog, which has three buttons: [[Image(source:trunk/images/dialogs/add.png,20,middle,link=)]] '''Add''', [[Image(source:trunk/images/dialogs/edit.png,20,middle,link=)]]'''Edit''' and [[Image(source:trunk/images/dialogs/delete.png,20,middle,link=)]]'''Delete'''.
    7574
    7675To edit the properties of a node or way (such as adding a tag) in the Tags/Membership Dialog, the way or node must be selected.
    77 1. ''Enter [wiki:Help/Action/Select Select mode] by clicking on [[Image(source:trunk/images/mapmode/move/move.png,20,middle,link=)]] of the left-hand icons or hitting the {{{S}}} key.''
     761. ''Enter [wiki:Help/Action/Select Select mode] by clicking on [[Image(source:trunk/images/mapmode/move/move.png,20,middle,link=)]] of the left-hand icons or by hitting the {{{S}}} key.''
    78771. ''Highlight the way or point you wish to select. Click the [[Image(source:trunk/images/dialogs/add.png,20,middle,link=)]]'''Add''' button.''
    79 1. ''A [wiki:Help/Dialog/AddValue dialog box] will appear, and you will be asked to select a key and a value for each tag. Type in the key/value pair that represents the tag you are creating. For example, for the key, you might type "highway," and for the value "secondary" (no quotes).''
     781. ''A [wiki:Help/Dialog/AddValue dialog box] will appear, and you will be asked to select a key and a value for each tag. Type in the key/value pair that represents the tag you are creating. For example, for the key you might type "highway" and for the value "secondary" (without quotes).''
    80791. ''Click OK. You have now tagged your way. You can add several tags to one object.
    8180''
    … …  
    8786=== Presets ===
    8887
    89 [wiki:Help/Concepts/Object#presets Instead of adding tags manually you can also use Presets].
     88Instead of adding tags manually you can also use [wiki:Help/Concepts/Object#presets Presets].
    9089
    91 All presets can be found: 1. from [wiki:Help/Menu main menu] (shown on the left below) 2. [Help/MainToolbar main toolbar] (no picture below). 3. {{{F3}}} shortcut (pop-up menu shown below on the right)
     90All presets can be found: 1. at the [wiki:Help/Menu main menu] (shown on the left below) 2. at the [Help/MainToolbar main toolbar] (no picture below). 3. with the {{{F3}}} shortcut (pop-up menu shown below on the right)
    9291
    9392[[Image(presets-from-main-menu.png,link=)]]
    9493[[Image(presets-f3-search.png,link=)]]
    9594
    96 Presets for [Help/Dialog/SelectionList#Selection currently selected object(s)] are displayed above tags for current object (displayed in [wiki:Help/Dialog/TagsMembership Tags/Memberships Dialog]):
     95Presets for [Help/Dialog/SelectionList#Selection currently selected object(s)] are displayed above the tags for the current object (displayed in [wiki:Help/Dialog/TagsMembership Tags/Memberships Dialog]):
    9796
    9897[[Image(presets-in-tag-toggle.png,link=)]]
    … …  
    104103=== Uploading to OSM ===
    105104
    106 If you are happy with all that you have done then you must upload your work to the OSM server. Click on the green up arrow [[Image(source:trunk/images/upload.png,20,middle,link=)]].
     105If you are happy with all that you have done then you must upload your work to the OSM server. Click on the [[Image(source:trunk/images/upload.png,20,middle,link=)]] button.
    107106
    108 This will automatically trigger [Help/Dialog/Validator validation]. Review all validation warnings and resolve all errors ([Help/Preferences/Validator#Listoferrors Complete list of errors and how to fix them]) before you upload. This will prevent unfortunate mistakes such as un-tagged objects or unconnected roads.
     107This will automatically trigger a [Help/Dialog/Validator validation] of your changes. Review all validation warnings and try to resolve them before you upload. This will prevent unfortunate mistakes such as un-tagged objects or unconnected roads. See also this [Help/Preferences/Validator#Listoferrors incomplete list] of errors and how to fix them. (Note that validator warnings can also be wrong in seldom special cases.)
    109108
    110 Before you upload, add a proper changeset comment and specify what source you used. This is important as it will show other users who see your changesets what this changeset was intended to modify and from where you took the information.
     109Before you upload, add a proper changeset comment and specify which source you used. This is important as it will show other users who see your changesets what this changeset was intended to modify and from where you took the information.
    111110
    112111[[Image(uploading data.gif,link=)]]
    … …  
    114113''JOSM will give you an overview of the elements that it is about to upload. You will be asked to provide a short text summary and the source of your edits. This description will be saved with your data on the server and provides information, for example, for the [osmwww:history Recent Changes list].''
    115114
    116 If you need more details or have questions about upload process, it is precisely covered at [wiki:Help/Action/Upload Upload to OSM] page.
     115If you need more details or have questions about upload process, it is precisely covered at [wiki:Help/Action/Upload Upload to OSM].
    117116
    118117== Thank you! ==
    119118
    120 No matter if you pick JOSM as your main tool or as [osmwiki:Editors#Choice_of_editors one of many editors], don't forget to [wiki:Help use help page] or simply press {{{F1}}} over button or any interface element, because we had no time to cover all topics.
     119Thanks for contributing to the OSM database. For more information see our [wiki:Help help page] or simply press {{{F1}}} over buttons or any interface element within JOSM. This will directly lead you to the respective help page.
    121120
    122 == What next ==
     121== What's next ==
    123122
    124123=== Results of your job ===
    125124
    126 * Will appear at [http://www.openstreetmap.org/#layers= openstreetmap.org "Standard" layer within few minutes]
     125* Your changes will appear at the [http://www.openstreetmap.org/#layers= "Standard" layer] probably within a few minutes.
    127126* Data in your routing software, maps and other services: will be updated per each service (from minutes to days, weeks and months)
    128127
    129128=== Tell your friends ===
    130129
    131 * How it is easy to update data, how your results get displayed quickly. Truck drivers, couriers, photographers, bikers, journalists, fisherman and simply runners with GPS are always welcome in OSM.
    132 * Precise and actual information may affect how you make decisions in your life. The more people active in project - the faster data gets updated. And while [http://osmstats.neis-one.org/?item=countries&date= a few contributors can be called as "active"] at given point in time. Every small change advances OSM to complete and actual state
    133 * OSM data may be viewed as clocks: without an arrow you wouldn't know minutes. it's often gets outdated - simply refresh it, when clock "stops" we wind up.
    134 * OpenStreetMap is about whole planet in the same way how your clock about current time
     130* Tell your friends how easy it is to update data and how your changes get displayed quickly. Truck drivers, couriers, photographers, bikers, journalists, fisherman and simply runners with GPS are always welcome in OSM.
     131* Precise and actual information may affect how you make decisions in your life. The more people who are active in the project - the faster the data gets updated. And while [http://osmstats.neis-one.org/?item=countries&date= a few contributors] can be called as "active" at a given point in time. Every small change advances OSM to a complete and actual state.
     132* OSM data may be viewed as clocks: without an arrow you wouldn't know minutes. It often gets outdated - simply refresh it. When clocks stop we wind them up again.
     133* OpenStreetMap is about the whole planet in the same way how your clock about the current time.
    135134
    136135= External links =
    137 * [https://github.com/mapbox/mapping/wiki/Mapping%20with%20JOSM Mapping with JOSM] with animations, by Mapbox team, covers mostly the same topics
     136* [https://github.com/mapbox/mapping/wiki/Mapping%20with%20JOSM Mapping with JOSM] with animations by Mapbox team covers mostly the same topic.
    138137* [https://www.mapbox.com/blog/making-the-most-josm/ Your first steps with JOSM - the Java OpenStreetMap editor] 09/02/2016 by Ramya Ragupathy at Mapbox blog
    139138