update mr tags page

src/en-us/documentation/using-maproulette-tags.md

@@ -1,9 +1,9 @@
 ---
 layout: base
-title: MR Tags
+title: Maproulette Tags
 tags: documentation
 eleventyNavigation:
-  key: MR Tags
+  key: Maproulette Tags
   parent: Working as a Team
   order: 5
 ---
@@ -12,5 +12,34 @@ eleventyNavigation:
 
 {% translate "UsingMaprouletteTags.content1", page.url | getUrlLang %}
 
-![](bad-imagery.png =500x)
+<div style="display: flex;">
+    <img src="/media/bad-imagery.png" alt="Image 1" style="width: 33%; margin-right: 10px;">
+    <img src="/media/mr-tags-11.png" alt="Image 3" style="width: 33%; margin-right: 10px;">
+    <img src="/media/mr-tags-10.png" alt="Image 2" style="width: 33%;">
+</div>
+
+{% translate "UsingMaprouletteTags.content3", page.url | getUrlLang %}
+
+![](mr-tags-3.png)
+
+{% translate "UsingMaprouletteTags.content4", page.url | getUrlLang %}
+
+<div style="display: flex;">
+    <img src="/media/mr-tags-4.png" alt="Image 4" style="width: 66%; margin-right: 10px;">
+    <img src="/media/mr-tags-12.png" alt="Image 5" style="width: 33%;">
+</div>
+
+{% translate "UsingMaprouletteTags.content5", page.url | getUrlLang %}
+
+<div style="display: flex;">
+    <img src="/media/mr-tags-1.png" alt="Image 4" style="width: 50%; margin-right: 10px;">
+    <img src="/media/mr-tags-6.png" alt="Image 5" style="width: 50%;">
+</div>
+
+![](mr-tags-2.png)
+
+{% translate "UsingMaprouletteTags.content6", page.url | getUrlLang %}
+
+![](mr-tags-13.png =1280x)
+
 

src/translations/en-us.json

@@ -133,8 +133,12 @@
   "UsingLayouts.content5": "### Exporting and Importing Layouts\n\nThe Layout dropdown menu (shown above) also contains options for exporting and importing layouts. Exporting allows you to download the layout configuration, which can then later be imported by you or someone else should you choose to send it to them. This can be especially useful for teams or at mapping parties. When you choose to export a layout, you'll be given an option to choose a new name in case something more generic would be more appropriate. The name you provide will be used to initially name the layout when it is later imported. Click the \"Download\" button when you're ready.",
   "UsingLayouts.content6": "Importing works the opposite way: simply click to choose a layout file to upload.",
   "UsingMapillaryImages.content1": "The Mapillary integration shows Mapillary image locations relevant to the task location, and we use the native Mapillary viewer widgets, so you can zoom in and easily skip to the next or previous images in a Mapillary sequence.",
-  "UsingMaprouletteTags.content1": "When you complete a task, you can now add a MapRoulette-specific tag to the task. Currently, you cannot search for these tags in MapRoulette, but they do appear in the CSV and GeoJSON task exports the Challenge owner can download. That makes them particularly interesting for Challenge owners. Say, for example, you have a challenge in an area where you know there may not be enough high-quality imagery available for mappers to complete all the tasks successfully. You can ask mappers to add a tag when they encounter that situation, for example `bad-imagery`. Later, when you download the tasks export, you can analyze the tags and find out which areas didn’t have good enough imagery (and start an OpenDroneMap + OpenAerialMap project there 🙂 )",
-  "UsingMaprouletteTags.content2": "MR stands for Maproulette, MR Tags are tags that are internal to MapRoulette, and they are used in special cases, and usually the task instructions will tell you when to use them. You can ignore them if not. It lets the creator of the challenge group and filter the tasks users complete in custom ways.",
+  "UsingMaprouletteTags.content1": "### How the Data is Used and Example of Useful Tag Use \n\n For example, if you have a challenge in an area where there may not be enough high-quality imagery available for mappers to complete all the tasks successfully, you can ask mappers to add a tag like `bad-imagery` when they encounter that situation. Later, when you download the tasks export, you can analyze the tags to find out which areas lacked good imagery, and potentially use that information to start something like an OpenDroneMap + OpenAerialMap project 🙂.",
+  "UsingMaprouletteTags.content2": "MapRoulette Tags, often called MR Tags, are primarily used for custom filtering and grouping tasks within a challenge. Currently, MR Tags are exclusive to MapRoulette and are not utilized or visible in other editors. If MR Tags are needed, the challenge manager will typically provide instructions on how to implement them within a task's description.",
+  "UsingMaprouletteTags.content3": "### Preferred MR Tags \n\n Set in the challenge editor, these are the tags that will be recommended to mappers and reviewers if they try to add MR Tags. There are two types of preferred tags: \n 1. Preferred MR Tags: Recommended in the task completion workflow, which is the workflow that most regular mappers use. \n 2. Preferred MR Review Tags: Recommended in the task review workflow, which is the workflow the reviewers use.",
+  "UsingMaprouletteTags.content4": "### Restricting MR Tags \n\n As per the editor settings, if the 'Allow other tags during task completion' or review is marked as 'No', the only tags that the user can input are the ones from the pool of tags the challenge manager added.",
+  "UsingMaprouletteTags.content5": "### Adding MR Tags \n\n Mappers and reviewers can add MR Tags from the completion widget. If there are currently no MR Tags on a task, the 'Add MR Tags' button will be displayed. This button opens up a modal that allows the user to modify the displayed tags.",
+  "UsingMaprouletteTags.content6": "MR Tags can also be added in the completion modal: ",
   "UsingOverpassToCreateChallenges.content1": "Overpass is a powerful query language for OSM. You can ask it things like \"Show me all water fountains in Rome\" or \"Show me banks that are more than 1km away from a police station\".\n\nYou can use Overpass queries directly in MapRoulette to generate tasks when you create a new Challenge. This page is here to help you do this, and avoid common mistakes.\n\n### A simple example\n\nImagine that you want to create a Challenge to have mappers look at bus stop nodes in a certain area. [This Overpass query](http://overpass-turbo.eu/s/Wh4) will give you all `highway=bus_stop` nodes in Salt Lake City:\n\n```\narea[name=\"Salt Lake City\"]->.a;\nnode[highway=bus_stop](area.a);\nout meta;\n```\n\nExplaining the full syntax of Overpass QL (the language this query is written in) is outside the scope of this article. Please look at the [language reference](https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL), [examples](https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_API_by_Example) and other Overpass related pages on the OSM wiki. OSM user Binette also has some [MapRoulette specific query examples](https://wiki.openstreetmap.org/wiki/User:Binnette/OverpassQueries) on their user page.\n\nYou can plug this query right into MapRoulette when you create a Challenge:",
   "UsingOverpassToCreateChallenges.content2": "After completing the Challenge wizard, your Tasks will reflect the result of the Overpass Query:",
   "UsingOverpassToCreateChallenges.content3": "## Common Pitfalls\n\n### `out center` returns both relations and ways as nodes; use `out geom` instead\n\n`out center` returns the correct coordinates, but instead of relations and ways, nodes are returned. This causes issues with editors because instead of searching for a `way` with `id = 9817324213`, we search for a `node` with `id = 9817324213`. This also causes problems with the MapRoulette maps as a single point will be displayed instead of a linestring.",