requested copyedits made

Author: Manushi Majumdar

guide/13-managing-arcgis-applications/enterprise-sites-guide.ipynb

@@ -7,14 +7,14 @@
    "source": [
     "# Introduction to Enterprise Sites features\n",
     "\n",
-    "ArcGIS Enterprise Sites allows you to create a tailored web page experience for your users to help you share your portal's authoritative GIS data to other departments more easily, even if they are not used to working in your GIS. Instead of learning to navigate the portal and access groups, members can go directly to the custom web page you create to navigate the content relevant to them. Click [here](https://enterprise.arcgis.com/en/sites/) to learn more about Enterprise Sites.\n",
+    "ArcGIS Enterprise Sites allows you to create a tailored web page experience for your users by allowing you to share your portal's authoritative GIS data to other departments more easily, even if they are not used to working in your GIS. Instead of learning to navigate the portal and access groups, members can go directly to the custom web page you create to navigate the content relevant to them. Click [here](https://enterprise.arcgis.com/en/sites/) to learn more about Enterprise Sites.\n",
     "\n",
-    "Note: The pattern to add, search, get, update, delete `Sites` and `Pages` is identical to that of __Initiatives__ (insert link to premium nb) as demonstrated here. \n",
+    "Note: The pattern to add, search, get, update and delete `Sites` and `Pages` is identical to that of __Initiatives__ (insert link to premium nb) as demonstrated here. \n",
     "\n",
-    "In this notebook we will take a look at examples to\n",
-    "* Create site with custom domain and pages\n",
-    "* Edit site theme\n",
-    "* Edit page layout"
+    "In this notebook, we will demonstrate how to\n",
+    "* Create a site with a custom domain and pages\n",
+    "* Edit a site's theme\n",
+    "* Edit a site's page layout"
    ]
   },
   {
@@ -32,11 +32,11 @@
    "id": "696a104d",
    "metadata": {},
    "source": [
-    "We will sign into an ArcGIS Enterprise organization to demonstrate these workflows. We can work with Enterprise Sites using the `sites` property of the `GIS` object. \n",
+    "First, we will sign into an ArcGIS Enterprise organization to demonstrate these workflows. We can work with Enterprise Sites using the `sites` property of the `GIS` object. \n",
     "\n",
     "Note: This workflow is for demonstration purposes only. To replicate this, you may have to sign-in to an ArcGIS Enterprise organization you have access to.\n",
     "\n",
-    "Here are examples for working with Initiatives and Events using __ArcGIS Premium__ (insert live URL) and site and page creation and cloning using __ArcGIS Basic__ (insert live URL) to see other ways of working with your Hub using the ArcGIS API for Python. "
+    "Here are examples for working with Initiatives and Events using __ArcGIS Premium__ (insert live URL) and site and page creation and cloning using __ArcGIS Basic__ (insert live URL) that demonstrate other ways of working with your Hub using the ArcGIS API for Python. "
    ]
   },
   {
@@ -188,7 +188,7 @@
    "id": "842b184b",
    "metadata": {},
    "source": [
-    "We fetch the value for the `background` color for this site theme, to change it."
+    "Next, we fetch the value for the `background` color for this site theme to change it."
    ]
   },
   {
@@ -274,8 +274,8 @@
     "\n",
     "The Site Editor provides a user with several capabilities in the form of __cards__ to simplify their site building and editing workflows. However, applying a common change to multiple sites and pages in your organization can become a tedious process.\n",
     "Using the site layout editing functionality supported in the Python API, you can successfully apply a common change across all the necessary sites and pages. \n",
-    "In order to programmatically edit a site, we need to take a deeper dive into the data model of a Site/Page item. The site layout has __Sections__ which contain __Rows__ within, and the row contain __Cards__ within. \n",
-    "Sections have configurable attributes such as background color and font-color and are used to theme a site or page. Rows are the building blocks of your site are implicitly created when you add a card to a section below another card. Whenever you want to add a card, such as a text card or image card, you must have a row card positioned where you want to add the content. Multiple cards can fit in a row card.\n",
+    "In order to programmatically edit a site, we need to take a deeper dive into the data model of a Site/Page item. The site layout has __Sections__ that contain __Rows__, and the rows further contain __Cards__. \n",
+    "Sections have configurable attributes, like background color and font-color, and are used to theme a site or page. Rows are the building blocks of your site and are implicitly created when you add a card to a section below another card. Whenever you want to add a card, such as a text card or image card, you must have a row card positioned where you want to add that content. Multiple cards can fit in a row card.\n",
     "\n",
     "![site_layout](https://user-images.githubusercontent.com/13968196/75702534-a8c25280-5c83-11ea-844a-1b513bdef50b.png)"
    ]
@@ -285,7 +285,7 @@
    "id": "ac17fa13",
    "metadata": {},
    "source": [
-    "We will see an example each of editing the layout of this site and its page. \n",
+    "Next, we will see an example of how to edit each aspect of the layout of this site and its page. \n",
     "\n",
     "The process is similar to editing the theme of the site. We fetch the layout of the site/page, make the required changes and commit them using the `update_layout()` method. "
    ]
@@ -313,7 +313,7 @@
    "id": "4a33646b",
    "metadata": {},
    "source": [
-    "You can access the nested sections, rows and cards of the layout as follows:"
+    "You can access the nested sections, rows and cards of the layout as shown below."
    ]
   },
   {
@@ -342,9 +342,9 @@
    "id": "01d0d218",
    "metadata": {},
    "source": [
-    "To add a new card you update the cards list - for the row within the section - with the dictionary for the new card.\n",
+    "To add a new card, you must update the cards list for the row within the section with the dictionary for the new card.\n",
     "\n",
-    "We start by first accessing the row of interest we would like to add the new card to."
+    "First, we will access the row we want to add the new card to."
    ]
   },
   {
@@ -373,7 +373,7 @@
    "id": "0bdb72ce",
    "metadata": {},
    "source": [
-    "The 1st row of 2nd section has 1 text card. We will now add another text card."
+    "The first row of second section has 1 text card. We will now add another text card."
    ]
   },
   {
@@ -408,7 +408,7 @@
    "id": "e4a57e25",
    "metadata": {},
    "source": [
-    "Let's publish these changes and verify them on the site."
+    "Now, we publish these changes and verify them on the site."
    ]
   },
   {
@@ -449,7 +449,7 @@
    "source": [
     "### Deleting a card from the page\n",
     "\n",
-    "We will now delete the red text card from the page that reads \"Where we're going\". We first fetch the layout of the page, delete the card from the layout and publish the changes.\n",
+    "We will now delete the red text card from the page that reads \"Where we're going\". To do this, we fetch the layout of the page, delete the card from the layout, and publish the changes.\n",
     "\n",
     "![image](https://user-images.githubusercontent.com/13968196/207743156-a671fc6b-f2ef-4484-909e-353436c88fe8.png)"
    ]
@@ -490,7 +490,7 @@
    "id": "863d2295",
    "metadata": {},
    "source": [
-    "We delete this card from the row."
+    "Next, we delete the card from the row."
    ]
   },
   {