with requested markdown changes

Author: Manushi Majumdar

guide/13-managing-arcgis-applications/hub-basic-guide.ipynb

@@ -17,9 +17,9 @@
    "source": [
     "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",
     "\n",
-    "In this notebook we will take a look at examples to\n",
-    "* Create site and pages\n",
-    "* Clone site within the same (Hub Basic) org, as well as in ArcGIS Enterprise and ArcGIS Hub Premium orgs\n",
+    "In this notebook, we will take a look at examples of how to\n",
+    "* Create a site and pages\n",
+    "* Clone a site within the same (Hub Basic) org, ArcGIS Enterprise orgs, and ArcGIS Hub Premium orgs\n",
     "* Link and unlink pages"
    ]
   },
@@ -38,11 +38,11 @@
    "id": "972dce0a",
    "metadata": {},
    "source": [
-    "We will now sign into a particular organization with Hub Basic capabilities for the purpose of demonstrating these workflows. \n",
+    "First, we will sign-in to an organization with Hub Basic capabilities for the purpose of demonstrating these workflows.\n",
     "\n",
-    "Note: In order to replicate these workflows for yourself, you may have to sign-in using your own credentials for your ArcGIS organization. This notebook is only designed for demonstration purposes. You may also want to verify the features available to you, per your ArcGIS Hub licensing. \n",
+    "Note: In order to replicate these workflows, you may have to sign-in using your own credentials for your ArcGIS organization. This notebook is only designed for demonstration purposes. You may also want to verify the features available to you, per your ArcGIS Hub licensing.\n",
     "\n",
-    "Here are examples for working with Initiatives and Events using __ArcGIS Premium__ (insert live URL) and site and page layout and theme editing using __Enterprise Sites__ (insert live URL) to see other ways of working with your Hub using the ArcGIS API for Python. "
+    "Below are examples for working with Initiatives and Events using __ArcGIS Premium__ (insert live URL), site and page layouts, and theme editing using __Enterprise Sites__ (insert live URL). "
    ]
   },
   {
@@ -88,7 +88,7 @@
    "source": [
     "### Adding new sites and pages\n",
     "\n",
-    "ArcGIS Hub empowers you with the capability to build configurable and branded websites for sharing internal and public content, such as apps, data, and media. If you're using ArcGIS Hub Premium, you can launch a site by creating an __initiative__ (insert premium hub link here). You can build a Hub Basic Site using the ArcGIS API for Python as follows:"
+    "ArcGIS Hub allows you to build configurable and branded websites for sharing internal and public content, such as apps, data, and media. If you're using ArcGIS Hub Premium, you can launch a site by creating an __initiative__ (insert premium hub link here). You can build a Hub Basic Site using the ArcGIS API for Python as follows:"
    ]
   },
   {
@@ -184,7 +184,7 @@
    "id": "a513da36",
    "metadata": {},
    "source": [
-    "You can also view all the pages of a site."
+    "You can also view all pages of a site."
    ]
   },
   {
@@ -215,7 +215,7 @@
    "source": [
     "### Cloning the site in the same organization\n",
     "\n",
-    "Cloning the site in the same organization is very straightforward, and replicates the layout of the site in its copy."
+    "Cloning the site in the same organization replicates the layout of the site in its copy."
    ]
   },
   {
@@ -265,11 +265,11 @@
    "source": [
     "### Cloning the site in an ArcGIS Enterprise organization\n",
     "\n",
-    "A feature exclusive to the Python API version of ArcGIS Hub is the ability to clone sites and initiatives cross-platform. \n",
+    "A feature exclusive to the Python API version of ArcGIS Hub, is the ability to clone sites and initiatives cross-platform.\n",
     "\n",
-    "Once we sign into our ArcGIS Enterprise target organization, we will be able to clone this site there, thus using the same layout of this site without having to re-create and re-configure it in another organization.\n",
+    "Once we sign into our ArcGIS Enterprise target organization, we will be able to clone this site there, allowing us to use the same layout of this site without having to re-create and re-configure it in another organization.\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."
+    "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"
    ]
   },
   {
@@ -297,7 +297,7 @@
    "source": [
     "We can work with Enterprise Sites using the `sites` property of the `GIS` object. \n",
     "\n",
-    "We will now clone our site from the Hub Basic organization to this Enterprise organization, in the exact same way we cloned it previously."
+    "We will now clone our site from the Hub Basic organization to the Enterprise organization in the same way we cloned it previously."
    ]
   },
   {
@@ -366,7 +366,7 @@
    "id": "426f220a",
    "metadata": {},
    "source": [
-    "As we see above, the page was cloned successfully along with the site."
+    "As we see above, the page and site were cloned successfully."
    ]
   },
   {
@@ -376,7 +376,7 @@
    "source": [
     "### Cloning the site in an ArcGIS Premium organization\n",
     "\n",
-    "We will now sign into a particular organization with Hub Premium enabled and will connect to the Hub associated with it, for the purpose of demonstrating the next few capabilities."
+    "We will now sign into an organization with Hub Premium enabled and will connect to the Hub associated with it."
    ]
   },
   {
@@ -412,7 +412,7 @@
    "id": "dcb0c70b",
    "metadata": {},
    "source": [
-    "We use the same `clone` method on the target organization to clone this site. However, you will notice that for a Hub Premium organization, your `clone` renders an `initiative` instead, with the site included. "
+    "We will use the same `clone` method on the target organization to clone this site. However, for a Hub Premium organization, your `clone` renders an `initiative` with the site included."
    ]
   },
   {
@@ -511,9 +511,9 @@
    "id": "c2cddbe5",
    "metadata": {},
    "source": [
-    "We see that the page was cloned successfully too. \n",
+    "We can see that the page was cloned successfully.\n",
     "\n",
-    "Let's fetch a page from another site and link it to this site. Page linking can be useful when you have certain pages in the same organization that are applicable to multiple sites (e.g., F.A.Q. pages, Contact Information pages, etc.) without having to recreate mutliple copies."
+    "Next, we will fetch a page from another site and link it to this site. Page linking can be useful when you have certain pages in the same organization that are applicable to multiple sites (e.g., F.A.Q. pages, Contact Information pages, etc.) but you do not want to recreate multiple copies of those pages. "
    ]
   },
   {
@@ -584,9 +584,7 @@
    "id": "c29a2650",
    "metadata": {},
    "source": [
-    "As we see above, the page was successfully linked to this site. \n",
-    "\n",
-    "We can also unlink pages from sites, as follows:"
+    "We can also unlink pages from sites:"
    ]
   },
   {