addressing Brecks comments

Author: CMPeng

guide/10-mapping-and-visualization-alt/Part2_Navigating_the_map_widget.ipynb

@@ -24,9 +24,8 @@
    "metadata": {},
    "source": [
     "## Using the map widget\n",
-    "Show creating a map widget and talk about the buttons and features\n",
     "\n",
-    "The `GIS` object includes a map widget for displaying geographic locations, visualizing GIS content, as well as the results of your analysis. To use the map widget, call `gis.map()` and assign it to a variable, that you can then query to bring up the widget in the notebook:"
+    "The `GIS` object includes a map widget for displaying geographic locations, visualizing GIS content, and displaying the results of your analysis. To use the map widget, call `gis.map()` and assign it to a variable that you will then be able to query to bring up the widget in the notebook:"
    ]
   },
   {
@@ -73,23 +72,23 @@
    "source": [
     "### Buttons\n",
     "\n",
-    "Now we have created a map view, let us explore the default buttons enabled on the widget:\n",
+    "Now that we have created a map view, let us explore the default buttons enabled on the widget:\n",
     "\n",
     "#### 1. Zoom in\n",
     "\n",
-    "Click the \"+\" sign shown on the top left corner of the widget (marked as button #1 in previous map output) to zoom into details of the map. Users can either manually zoom into a desired level of details, or set the zoom levels to an assigned number (which is to be introduced in the next section).\n",
+    "Click the \"+\" sign shown on the top left corner of the widget (marked as button #1 in previous map output) to zoom into details of the map. Users can either manually zoom into a desired level of detail or set the zoom levels to an assigned number, which we will elaborate on in the next section.\n",
     "\n",
     "#### 2. Zoom out\n",
     "\n",
-    "Click the \"-\" sign shown on the top left corner of the widget (marked as button #2 in previous map output) to zoom out to a rough display of the map. Users can either manually zoom out to a desired level of details, or set the zoom levels to an assigned number (which is to be introduced in the next section).\n",
+    "Click the \"-\" sign shown on the top left corner of the widget (marked as button #2 in previous map output) to zoom out to a rough display of the map. Users can either manually zoom out to a desired level of details, or set the zoom levels to an assigned number, which we will elaborate on in the next section.\n",
     "\n",
     "#### 3. Reset the compass orientation\n",
     "\n",
-    "Click the compass sign (marked as button #3 in the previous map display) to switch the map's heading to 0.0 (north) in relation to current device, and click one more time to switch back to the absolute 0.0 north.\n",
+    "Click the compass sign (marked as button #3 in the previous map display) to switch the map's heading to 0.0 (north) in relation to the current device, and click again to switch back to the absolute 0.0 north.\n",
     "\n",
     "#### 4. 2D Map to 3D Scene\n",
     "\n",
-    "Click the \"Map to Scene\" button (marked as #4 in the previous map display) to switch the current view from 2D Map to 3D Scene, and click the same button one more time to switch back."
+    "Click the \"Map to Scene\" button (marked as #4 in the previous map display) to switch the current view from a 2D Map to a 3D Scene. Click the button again to switch back."
    ]
   },
   {
@@ -105,8 +104,7 @@
    "source": [
     "### Operations of the map widget\n",
     "\n",
-    "The map widget has several properties that you can query and set, such as its zoom level, basemap, height, extent, mode, heading, rotation, tilt, scale etc.\n",
-    "(when discussing, start off by asking user to zoom and pan to some area of interest and show the values of these properties. Then show how you can drive the widget through code by assigning values to the properties)\n",
+    "The map widget has several properties that you can query and set, such as its zoom level, basemap, height, extent, mode, heading, rotation, tilt, scale, etc.\n",
     "\n",
     "#### Zoom Level and Rotation\n"
    ]
@@ -176,7 +174,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "You can also set rotation in 2D mode. This can also be achieved by right-clicking and dragging on the map."
+    "You can also set the rotation property for the 2D mode. This can similarly be achieved by right-clicking and dragging on the map."
    ]
   },
   {
@@ -192,7 +190,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Your notebook can have as many of these widgets as you wish. Let us create another map widget and modify some of its properties."
+    "Your notebook can have as many of these widgets as you wish. Let's create another map widget and modify some of its properties."
    ]
   },
   {
@@ -274,9 +272,9 @@
    "source": [
     "#### Extent\n",
     "\n",
-    "You can use geocoding to get the coordinates of place names and drive the widget. Geocoding converts place names to coordinates and can be used using `arcgis.geocoding.geocode()` function.\n",
+    "You can use `geocoding` to get the coordinates of different places and use those coordinates to drive the extent property. `Geocoding` converts place names to coordinates and can be implemented by using the `arcgis.geocoding.geocode()` function.\n",
     "\n",
-    "Let us geocode \"Disneyland, CA\" and set the map's extent to the geocoded location's extent."
+    "Let's geocode \"Disneyland, CA\" and set the map's extent to the geocoded location's extent:"
    ]
   },
   {
@@ -295,16 +293,16 @@
    "source": [
     "#### Basemap\n",
     "\n",
-    "<a href=\"https://livingatlas.arcgis.com/en/\">ArcGIS Living Atlas of the World</a> is an evolving collection of authoritative, curated, ready-to-use global geographic information from Esri, and the GIS user community, one of whose most used types are basemaps. `Basemap` are layers on your map over which all other operational layers that you add are displayed. Basemaps typically span the full extent of the world and provide context to your `GIS` layers. It helps viewers understand where each feature is located as they pan and zoom to various extents.\n",
+    "<a href=\"https://livingatlas.arcgis.com/en/\">ArcGIS Living Atlas of the World</a> is an evolving collection of authoritative, curated, ready-to-use global geographic information from Esri and the GIS user community. One of the most used types of content from the Living Atlas is basemaps. Basemaps are layers on your map over which all other operational layers that you add are displayed. Basemaps typically span the full extent of the world and provide context to your `GIS` layers. It helps viewers understand where each feature is located as they pan and zoom to various extents.\n",
     "\n",
-    "When you create a new map or scene, you can choose which `basemap` you want from the basemap gallery in the Map Viewer. By default, the basemap gallery for your organization is a pre-configured collection from Esri using the Living Atlas. There are many more Living Atlas basemaps to choose from, and you can create your own custom basemap gallery with the ones you like. Here’s <a href=\"https://www.esri.com/arcgis-blog/products/arcgis-online/mapping/living-atlas-custom-basemap-gallery/\">how</a>.\n",
+    "When you create a new map or scene, you can choose which basemap you want from the basemap gallery in the Map Viewer. By default, the basemap gallery for your organization is a pre-configured collection from Esri using the Living Atlas. There are many more Living Atlas basemaps to choose from, and you can create your own custom basemap gallery with the ones you like. Learn more on this <a href=\"https://www.esri.com/arcgis-blog/products/arcgis-online/mapping/living-atlas-custom-basemap-gallery/\">here</a>.\n",
     "\n",
-    "As an administrator of your organization, you can change which basemaps your organization uses by creating a custom basemap gallery. The custom gallery can include a combination of your own basemaps, plus Living Atlas basemaps. In a nutshell, the steps to create a custom Basemap Gallery are:\n",
+    "As an administrator of your organization, you can change which basemaps your organization uses by creating a custom basemap gallery. The custom gallery can include a combination of your own basemaps, plus Living Atlas basemaps. In a nutshell, the steps to create a custom basemap gallery are as follows: \n",
     " - Createa group for your custom basemap gallery.\n",
     " - Add maps you want to use as basemaps to the group.\n",
-    " - Set the group as your organization’s basemap gallery. \n",
+    " - Set the group as your organization’s basemap gallery.\n",
     " \n",
-    "These steps are detailed in <a href=\"https://www.esri.com/arcgis-blog/products/arcgis-online/mapping/custom-basemap-gallery/\">Create a custom basemap gallery for your organization</a>. After step one is done, users can move forward to :\n",
+    "These steps are detailed in the <a href=\"https://www.esri.com/arcgis-blog/products/arcgis-online/mapping/custom-basemap-gallery/\">Create a custom basemap gallery for your organization</a> blog. After step one is done, users can move forward to :\n",
     " - <a href=\"https://doc.arcgis.com/en/arcgis-online/share-maps/create-groups.htm\">create a custom basemap group</a>\n",
     " - <a href=\"https://www.esri.com/arcgis-blog/products/arcgis-online/mapping/living-atlas-custom-basemap-gallery/\">adding maps from the Living Atlas to populate your custom gallery</a>\n",
     "\n",
@@ -391,7 +389,7 @@
    "source": [
     "#### Mode\n",
     "\n",
-    "The map widget also includes support for 3D mode! You can specify the `mode` parameter through `gis.map(mode=\"foo\")`, or by setting the mode property of any initiated map object. Run the below cell:"
+    "The map widget also includes support for a 3D mode! You can specify the `mode` parameter either through `gis.map(mode=\"foo\")` or by setting the mode property of any initiated map object. Run the following cell:"
    ]
   },
   {
@@ -433,9 +431,9 @@
    "source": [
     "#### Heading, tilt and scale\n",
     "\n",
-    "Just like 2D mode, you can pan by click-and-drag with the left mouse button, and you can zoom with the mouse wheel. In 3D mode, click-and-drag with the right mouse button modifies the tilt field and the heading field.\n",
+    "Just like the 2D mode, you can pan by clicking-and-dragging with the left mouse button, and you can zoom with the mouse wheel. In 3D mode, clicking-and-dragging with the right mouse button modifies the tilt field and the heading field.\n",
     "\n",
-    "`tilt` is a number from 0-90: 0 represents a top-down 'birds-eye' view, while 90 represents being completely parallel to the ground, facing the horizon."
+    "`tilt` is a number from 0-90, with 0 representing a top-down 'birds-eye' view, while 90 represents being completely parallel to the ground, facing the horizon."
    ]
   },
   {
@@ -518,7 +516,7 @@
     "\n",
     "#### Stacking maps using HBox and VBox\n",
     "\n",
-    "One commonly adopted workflow in order to create multiple widgets in a same notebook, is to embed Python API map widgets within `HBox` and `VBox`. First, let us walk through an example of showing Landsat imageries of two different dates side by side using an `HBox` structure here:"
+    "One commonly adopted workflow for creating multiple widgets in the same notebook is to embed Python API map widgets within `HBox` and `VBox`. First, let's walk through an example of displaying Landsat imagery of two different dates side by side using an `HBox` structure:"
    ]
   },
   {
@@ -860,7 +858,7 @@
    "source": [
     "####  Synchronizing nav between multiple widgets\n",
     "\n",
-    "The side-by-side display of two maps is great for users to explore the difference between both maps. However, if one map gets dragged or panned, the other one is not following the movements automatically. The methods `sync_navigation` and `unsync_navigation` are introduced to handle this issue. we can now modify the previous example to have the maps in sync."
+    "A side-by-side display of two maps is great for users wanting to explore the differences between two maps. However, if one map gets dragged or panned, the other map is not following the movements automatically. The methods `sync_navigation` and `unsync_navigation` can be introduced to resolve this. With these methods, we can modify the previous example to have the maps in sync."
    ]
   },
   {
@@ -1235,7 +1233,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Dragging and panning onto any of these 4 maps will lead to synchronous movements of other three maps, which means that the map center, zoom levels, and extent of these maps will always stay the same - this is one of the biggest advantages of `sync_navigation()`."
+    "Dragging and panning onto any of these 4 maps will lead to synchronous movements of the other three maps, which means that the map center, zoom levels, and extent of these maps will always stay the same. This is one of the biggest advantages of `sync_navigation()`."
    ]
   },
   {
@@ -1244,15 +1242,15 @@
    "source": [
     "## Conclusion\n",
     "\n",
-    "In Part 2 of the guide series, we have talked about the usage of the map widget, including buttons, features, and properties, and have seen three examples of displaying multiple map widgets in a group view using HBox and VBox. In the next chapter, we will discuss how to visualize spatial data onto the map widget.\n",
+    "In Part 2 of the guide series, we have talked about the use of map widgets, including buttons, features, and properties, and have seen three examples of displaying multiple map widgets in a group view using `HBox` and `VBox`. In the next chapter, we will discuss how to visualize spatial data on the map widget.\n",
     "\n",
     "<a href=\"#Part-2---Navigating-the-map-widget\">Back to Top</a>"
    ]
   }
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -1266,7 +1264,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.7.10"
+   "version": "3.7.11"
   },
   "toc": {
    "base_numbering": 1,