requested copyedits made

Author: Manushi Majumdar

samples/02_power_users_developers/introduction_to_hub_initiatives_and_sites.ipynb

@@ -6,7 +6,7 @@
    "source": [
     "## Introduction to Hub Initiatives and Sites\n",
     "\n",
-    "In this sample notebook we will see how to search for initiatives across a Hub, create a new initiative and edit the layout of its site, linking and unlinking a page to that site, cloning it. The same site is also cloned to an Enterprise organization to demonstrate cross-platform cloning of Hub Sites. We also see how a site can be fetched using just its domain. "
+    "In this sample notebook we will demonstrate how to search for initiatives across a Hub, create a new initiative and edit the layout of its site, link and unlink a page to that site, and clone a site. We will also clone the same site to an Enterprise organization to demonstrate cross-platform cloning of Hub Sites. Finally, we will demonstrate how a site can be fetched using its domain. "
    ]
   },
   {
@@ -24,7 +24,7 @@
    "source": [
     "### Login to Hub\n",
     "\n",
-    "In the interest of demonstrating the Hub Premium `Initiative`, we are signing into this particular Hub. Please sign-in with your ArcGIS credentials while executing this sample notebook to leverage the capabilities of your Hub/Sites licensing."
+    "In the interest of demonstrating the Hub Premium `Initiative`, we will sign into a Hub. Sign-in with your ArcGIS credentials while executing this sample notebook to leverage the capabilities of your Hub/Sites licensing."
    ]
   },
   {
@@ -59,7 +59,7 @@
    "source": [
     "### Searching for Initiatives\n",
     "\n",
-    "You can search for initiatives or filter using parameters such as `title`, `owner`, `tags`"
+    "You can either search for initiatives or filter using parameters like `title`, `owner`, `tags`."
    ]
   },
   {
@@ -220,7 +220,7 @@
    "source": [
     "### Linking a page to this site\n",
     "\n",
-    "Linking a page to a site is a two step process. You start by fetching the page of interest, and then linking it to the site object with a slug for the page."
+    "Linking a page to a site is a two step process. First, you will fetch the page of interest, then you will link it to the site object with a slug for that page."
    ]
   },
   {
@@ -290,7 +290,7 @@
    "source": [
     "### Unlinking a page from this site\n",
     "\n",
-    "Unlinking is useful when you have a page that is no longer needed for a site, but you do not wish to delete it from other sites it is linked to."
+    "Unlinking is useful when you have a page that is no longer needed for a site, but you do not wish to delete that page from the other sites it is linked to."
    ]
   },
   {
@@ -320,7 +320,7 @@
    "source": [
     "### Editing the layout of this site\n",
     "\n",
-    "We start by fetching the layout of the this site."
+    "To edit a layout of a site, first fetch the layout of that site."
    ]
   },
   {
@@ -356,7 +356,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "As we see, this section has a blue background color.\n",
+    "As we can see, this section has a blue background color.\n",
     "\n",
     "![image](https://user-images.githubusercontent.com/13968196/158464500-fbb3fa83-f091-41ba-b2eb-740a633a2078.png)\n"
    ]
@@ -365,7 +365,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "We now change it to a deep red by assigning the value and then calling the `update_layout` method on the site object."
+    "We can change it to a deep red by assigning the background color value and calling the `update_layout` method on the site object."
    ]
   },
   {
@@ -413,7 +413,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "As we see the color has successfully changed.\n",
+    "The background color is now a dark red.\n",
     "\n",
     "![image](https://user-images.githubusercontent.com/13968196/158464917-76a90219-127b-4a74-ac3e-4c70de62f3e4.png)\n"
    ]
@@ -433,7 +433,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "We proceed with fetching the card for this section, and then updating it with the json for the new title 'DevSummit 2022'."
+    "To change this, we can fetch the card for this section and update it with the json for the new title 'A Sample Hub Initiative'."
    ]
   },
   {
@@ -501,11 +501,10 @@
    ]
   },
   {
-   "attachments": {},
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "And the title has successfully changed.\n",
+    "Now the title has successfully been changed.\n",
     "\n",
     "![image](https://user-images.githubusercontent.com/13968196/213138931-409df3e5-019b-4805-a246-4ee00eb67ee7.png)"
    ]
@@ -516,7 +515,7 @@
    "source": [
     "### Fetching sites with site domain\n",
     "\n",
-    "Sites can be fetched by their itemid. But in case you do not have the siteid for a site that you have access to, you can fetch the item as follows:"
+    "Sites can be fetched by their `itemid`. However, in cases where you do not have the `siteid` for a site that you have access to, you can fetch the item using the following command:"
    ]
   },
   {
@@ -564,7 +563,7 @@
    "source": [
     "### Cloning an initiative/site in the same org\n",
     "\n",
-    "We clone an initiaitve in the same org by passing the initiative object to the clone method."
+    "We clone an initiaitve in the same organization by passing the initiative object to the clone method."
    ]
   },
   {
@@ -612,7 +611,7 @@
    "source": [
     "### Cloning an initiative/site from Hub to Enterprise\n",
     "\n",
-    "Cloning an initiative to Enterprise requires signing into that org and then cloning the site into it, by calling the clone method on the `sites` property of the target `GIS` object and also providing a reference to the site object and optional title. \n",
+    "Cloning an initiative to Enterprise requires signing into that organization and then cloning the site into it. You can clone a site by calling the clone method on the `sites` property of the target `GIS` object and providing a reference to the site object and an optional title. \n",
     "\n",
     "Note: Enterprise Sites are supported via the `sites` submodule of the `GIS`, and not the `apps.hub` submodule. "
    ]
@@ -677,7 +676,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "As we notice here, only the site item has been cloned in the new org since this is an Enterprise org. The script understands whether to give you an initiative or site for your particular Hub."
+    "Only the site item has been cloned in the new organization as this is an Enterprise organization. The script will automatically determine whether to give you an initiative or a site for your particular Hub."
    ]
   },
   {
@@ -686,7 +685,7 @@
    "source": [
     "### Deleting initiatives and sites\n",
     "\n",
-    "We will delete the initiative and site created as part of this notebook to demonstrate the ease of deletion."
+    "We will delete the initiatives and site created as part of this notebook to demonstrate the process of deletion."
    ]
   },
   {