Add inspector docs

Makefile

@@ -9,7 +9,7 @@ all: \
 	iD.js \
 	iD.min.js
 
-DATA_FILES = $(shell find data -type f -name '*.json')
+DATA_FILES = $(shell find data -type f -name '*.json' -o -name '*.md')
 data/data.js: $(DATA_FILES)
 	node build.js
 

data/doc.json

@@ -4,7 +4,7 @@
         "title": "Help"
     },
     {
-        "html": "<p>This editor is designed to work primarily online, and you&#39;re accessing\nit through a website right now.</p>\n<p>When you create changes, like editing roads, buildings, and places, these are\nstored locally until you save them to the server. Don&#39;t worry if you make\na mistake - you can undo changes by clicking the undo button, and redo\nchanges by clicking the redo button.</p>\n<p>Click &#39;Save&#39; to finish a group of edits - for instance, if you&#39;ve completed\nan area of town and would like to start on a new area. You&#39;ll have a chance\nto review what you&#39;ve done, and the editor supplies helpful suggestions\nand warnings if something doesn&#39;t seem right about the changes.</p>\n<p>Clicking &#39;Save&#39; again, on the new dialog, will post the changes\nto <a href=\"http://www.openstreetmap.org/\">OpenStreetMap.org</a>, where they are visible\nto all other users and available for others to build and improve upon.</p>\n<p>If you can&#39;t finish your edits in one sitting, you can leave the editor\nwindow and come back (on the same browser and computer), and the\neditor application will offer to restore your work.</p>\n",
+        "html": "<p>This editor is designed to work primarily online, and you&#39;re accessing\nit through a website right now.</p>\n<h2>Selecting Features</h2>\n<p>To select a map feature, like a road or point of interest, simply single-click\non it on the map. This will highlight the selected feature, show a panel of\ndetails, and also show a menu of things you can do with the feature.</p>\n<p>Multiple features can be selected by holding the &#39;Shift&#39; key, clicking,\nand dragging on the map. This will select all features within the box\nthat&#39;s drawn, and you can do certain &#39;batch operations&#39; on all features.</p>\n<h2>Saving Edits</h2>\n<p>When you create changes, like editing roads, buildings, and places, these are\nstored locally until you save them to the server. Don&#39;t worry if you make\na mistake - you can undo changes by clicking the undo button, and redo\nchanges by clicking the redo button.</p>\n<p>Click &#39;Save&#39; to finish a group of edits - for instance, if you&#39;ve completed\nan area of town and would like to start on a new area. You&#39;ll have a chance\nto review what you&#39;ve done, and the editor supplies helpful suggestions\nand warnings if something doesn&#39;t seem right about the changes.</p>\n<p>Clicking &#39;Save&#39; again, on the new dialog, will post the changes\nto <a href=\"http://www.openstreetmap.org/\">OpenStreetMap.org</a>, where they are visible\nto all other users and available for others to build and improve upon.</p>\n<p>If you can&#39;t finish your edits in one sitting, you can leave the editor\nwindow and come back (on the same browser and computer), and the\neditor application will offer to restore your work.</p>\n",
         "title": "Editing & Saving"
     },
     {
@@ -23,6 +23,10 @@
         "html": "<p>Addresses are some of the most useful information for the map.</p>\n<p>Although addresses are often represented as parts of streets, in OpenStreetMap\nthey&#39;re recorded as attributes of buildings and places along streets.</p>\n<p>You can add address information to places mapped as building outlines as well\nas well as those mapped as single points. The optimal source of address\ndata is from an on-the-ground survey or personal knowledge - as with any\nother feature, copying from commercial sources like Google Maps is strictly\nforbidden.</p>\n",
         "title": "Addresses"
     },
+    {
+        "html": "<p>The inspector is the user interface element on the right-hand side of the\npage that appears when an element is selected and allows to edit its details.</p>\n<h3>Selecting a Preset</h3>\n<p>The inspector has two modes: the first allows you to pick a preset, or\npredetermined selection of forms and tags.</p>\n<p>Click the &#39;i&#39; in the bottom-right-hand corner of a preset option to learn\nmore about it. Click a preset to choose it.</p>\n<h3>Using Forms and Editing Tags</h3>\n<p>The second allows you to edit the\nattributes of a map element using those forms and tags.</p>\n<p>Below the forms you see, you can click icons to add more easy-to-use forms,\nlike <a href=\"http://www.wikipedia.org/\">Wikipedia</a> information, wheelchair\naccess, and more.</p>\n<p>At the bottom of the inspector, click &#39;Additional tags&#39; to add arbitrary\nother tags to the element. <a href=\"http://taginfo.openstreetmap.org/\">Taginfo</a> is a\ngreat resource for learn more about popular tag combinations.</p>\n<p>Changes you make in the inspector are automatically applied to the map.\nYou can undo them at any time by clicking the Undo button.</p>\n<h3>Closing the Inspector</h3>\n<p>You can close the inspector by either clicking the close button in the top-right,\npressing the &#39;Escape&#39; key, or clicking on the map.</p>\n",
+        "title": "Using the Inspector"
+    },
     {
         "html": "<p>OpenStreetMap is the world&#39;s largest database of buildings. You can create\nand improve this database.</p>\n<h3>Selecting</h3>\n<p>You can select a building by clicking on its border. This will highlight the\nbuilding and open a small tools menu and a sidebar showing more information\nabout the building.</p>\n<h3>Modifying</h3>\n<p>Sometimes buildings are incorrectly placed or have incorrect tags.</p>\n<p>To move an entire building, select it, then click the &#39;Move&#39; tool. Move your\nmouse to shift the building, and click when it&#39;s correctly placed.</p>\n<p>To fix the specific shape of a building, click and drag the points that form\nits border into better places.</p>\n<h3>Creating</h3>\n<p>One 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 <em>map a building as a shape whenever possible</em>, and map companies, homes,\namenities, and other things that operate out of buildings as points placed\nwithin the building shape.</p>\n<p>Start drawing a building as a shape by clicking the &#39;Area&#39; button in the top\nleft of the interface, and end it either by pressing &#39;Return&#39; on your keyboard\nor clicking on the first point drawn to close the shape.</p>\n<h3>Deleting</h3>\n<p>If a building is entirely incorrect - you can see that it doesn&#39;t exist in satellite\nimagery and ideally have confirmed locally that it&#39;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 road could simply be newly built.</p>\n<p>You can delete a building by clicking on it to select it, then clicking the\ntrash can icon or pressing the &#39;Delete&#39; key.</p>\n",
         "title": "Buildings"

data/doc/07-inspector.md

@@ -0,0 +1,33 @@
+# Using the Inspector
+
+The inspector is the user interface element on the right-hand side of the
+page that appears when an element is selected and allows to edit its details.
+
+### Selecting a Preset
+
+The inspector has two modes: the first allows you to pick a preset, or
+predetermined selection of forms and tags.
+
+Click the 'i' in the bottom-right-hand corner of a preset option to learn
+more about it. Click a preset to choose it.
+
+### Using Forms and Editing Tags
+
+The second allows you to edit the
+attributes of a map element using those forms and tags.
+
+Below the forms you see, you can click icons to add more easy-to-use forms,
+like [Wikipedia](http://www.wikipedia.org/) information, wheelchair
+access, and more.
+
+At the bottom of the inspector, click 'Additional tags' to add arbitrary
+other tags to the element. [Taginfo](http://taginfo.openstreetmap.org/) is a
+great resource for learn more about popular tag combinations.
+
+Changes you make in the inspector are automatically applied to the map.
+You can undo them at any time by clicking the Undo button.
+
+### Closing the Inspector
+
+You can close the inspector by either clicking the close button in the top-right,
+pressing the 'Escape' key, or clicking on the map.