addressed requested changes

Author: ManushiM

guide/13-managing-arcgis-applications/introduction-to-storymaps.ipynb

@@ -13,12 +13,12 @@
    "id": "6772bf0f-2a6b-438a-8757-472398dd3dc6",
    "metadata": {},
    "source": [
-    "ArcGIS StoryMaps is a web-based content-creation and communication tool that allows you to share maps, apps, and multimedia in the context of a narrative. You can use ArcGIS StoryMaps to author stories, which are like articles or blogs. Stories offer a scrolling narrative experience with immersive sections and can integrate maps and data from your organization. It is an application supported in both ArcGIS Enterprise and ArcGIS Online. "
+    "ArcGIS StoryMaps is a web-based content-creation and communication tool that allows you to share maps, apps, and multimedia in the context of a narrative. You can use ArcGIS StoryMaps to author stories, which are similar to articles or blogs. Stories offer a scrolling narrative experience with immersive sections and can integrate maps and data from your organization. It is an application supported in both ArcGIS Enterprise and ArcGIS Online. "
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 85,
+   "execution_count": 1,
    "id": "cf9da6fa-a5c8-4e10-b09e-7cf2ec45c3c1",
    "metadata": {},
    "outputs": [],
@@ -41,7 +41,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 86,
+   "execution_count": 2,
    "id": "6661719a-fe2a-4dae-b510-6ca45f80c89d",
    "metadata": {},
    "outputs": [],
@@ -92,9 +92,9 @@
     "* [Cover](https://developers.arcgis.com/python/latest/api-reference/arcgis.apps.storymap.html#cover)\n",
     "* [Separator](https://developers.arcgis.com/python/latest/api-reference/arcgis.apps.storymap.html#separator)\n",
     "\n",
-    "As we see in the list above, content can be of various class types and you have the option to specify a `caption`, `alt_text`, `display` style, and the `position` at which it will be in your story while adding the particular content element to your story. Not passing in any content means a separator will be added.\n",
+    "As we see in the list above, content can be of various class types and you have the option to specify a `caption`, `alt_text`, `display` style, and the `position` at which it will be in your story while adding the particular content element to your story. \n",
     "\n",
-    "Let us understand this process of adding content to our story through examples of some popular content element types. "
+    "Below we will go through different examples of content being added to a story. "
    ]
   },
   {
@@ -104,7 +104,23 @@
    "source": [
     "### 1. Adding text to describe the theme of the StoryMap\n",
     "\n",
-    "We will start by adding `Text` to our story, specifically a Heading for the story using the `style` parameter."
+    "\n",
+    "You can add `Text` to your story by providing the text string of choice to the`text` parameter of this [Text class](https://developers.arcgis.com/python/latest/api-reference/arcgis.apps.storymap.html#text).\n",
+    "\n",
+    "You can also specify the `style` you would like to render your text in, using the following [`TextStyles` enumeration](https://developers.arcgis.com/python/latest/api-reference/arcgis.apps.storymap.html#arcgis.apps.storymap.story_content.TextStyles) values supported in the ArcGIS API for Python.\n",
+    "\n",
+    "* BULLETLIST = 'bullet-list'\n",
+    "* NUMBERLIST = 'numbered-list'\n",
+    "* HEADING = 'h2'\n",
+    "* SUBHEADING = 'h3'\n",
+    "* HEADING1 = 'h2'\n",
+    "* HEADING2 = 'h3'\n",
+    "* HEADING3 = 'h4'\n",
+    "* PARAGRAPH = 'paragraph'\n",
+    "* QUOTE = 'quote'\n",
+    "\n",
+    "\n",
+    "We will start by adding a Heading for the story using the `style` parameter."
    ]
   },
   {
@@ -114,11 +130,12 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "title = Text(\n",
+    "heading = Text(\n",
     "    text=\"Nature themed story\",\n",
     "    style=TextStyles.HEADING,\n",
     ")\n",
-    "heading = my_story.add(title)"
+    "\n",
+    "my_story.add(heading)"
    ]
   },
   {
@@ -204,6 +221,16 @@
     "my_story.add(img, caption = \"Trees with a deer\", alt_text = \"Sequoia trees in the distance\")"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "f5646e7a-15ac-43dd-b18e-4e9192f3d1b7",
+   "metadata": {},
+   "source": [
+    "The `Image` class takes either the file path or url to the image as input.\n",
+    "\n",
+    "Note: The `Image360` class shown below takes _only_ the url as input. "
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 91,
@@ -288,17 +315,9 @@
    "source": [
     "### 3. Adding a gallery of images\n",
     "\n",
-    "We can expand this concept to add a `Gallery` of Images. You can added up to 12 images to a `Gallery` in a StoryMap. "
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 93,
-   "id": "c05704e0-d601-4664-b47d-e925a09924cc",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "gallery = Gallery()"
+    "We can expand this concept of adding an `Image` to add a `Gallery` of images.\n",
+    "\n",
+    "We learned how to create images with the `Image` class. We now create images, and then add them as inputs to the `Gallery` class. You can added up to 12 images to a `Gallery` in a StoryMap. "
    ]
   },
   {
@@ -598,18 +617,29 @@
    "id": "95218931-5a4c-43c7-aa71-fb9ebbc5fe5a",
    "metadata": {},
    "source": [
-    "### 6. Add a sidecar with a map and button\n",
+    "### 6. Add a `Sidecar` with a `Map` and `Button`\n",
+    "\n",
+    "Sidecars are a set of slides that combine maps, pictures, videos, web content, and text to help you tell your story. As you go through the slides, the pictures and videos change to match what you are reading, and you can adjust maps in the slides to show different locations and layers.\n",
+    "\n",
+    "A `Sidecar` is composed of slides. Slides are composed of two sub structures: \n",
+    "* a narrative panel and\n",
+    "* a media panel.\n",
+    "\n",
+    "The media panel can be a(n): `Image`, `Image360`, `Video`, `Embed`, `Map`, or `Swipe`. \n",
+    "\n",
+    "The narrative panel can contain multiple types of content including `Image`, `Image360`, `Video`, `Embed`, `Button`, `Text`, `Map`, and more.\n",
+    "\n",
     "\n",
     "What sets ArcGIS StoryMaps apart from other web-based authoring tools is the ability to integrate maps with other multimedia elements (words, images, videos, audio, and embedded content). Maps guide readers from place to place, they show change over time, and reveal patterns and relationships. Maps add dimensions to stories that are difficult or impossible to achieve with other media. \n",
     "\n",
     "We will add a `Map` to a `Sidecar` along with a `Button` in this section.\n",
     "\n",
-    "A `Sidecar` is composed of slides. Slides are composed of two sub structures: a narrative panel and a media panel. The media node can be a(n): `Image`, `Image360`, `Video`, `Embed`, `Map`, or `Swipe`. The narrative panel can contain multiple types of content including `Image`, `Image360`, `Video`, `Embed`, `Button`, `Text`, `Map`, and more."
+    "For the example below, we will create a new `Web Map` using the Python API's mapping module. We will add a layer to this map and save it for use in the rest of our storymap."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 103,
+   "execution_count": 3,
    "id": "a9e96374-bf6a-4f27-8ba4-31f284475f11",
    "metadata": {},
    "outputs": [],
@@ -625,9 +655,17 @@
     ")"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "49ef61ef-5b1e-46f3-8a4b-3f7343261dd4",
+   "metadata": {},
+   "source": [
+    "We can now use the Storymap `Map` content class to add our newly created `Web Map` item to the storymap."
+   ]
+  },
   {
    "cell_type": "code",
-   "execution_count": 104,
+   "execution_count": 4,
    "id": "0262a0ff-fdd5-4ba9-9d48-a1816fa82a6b",
    "metadata": {},
    "outputs": [],
@@ -651,10 +689,10 @@
    "outputs": [],
    "source": [
     "media_panel.set_viewpoint(extent = {'spatialReference': {'latestWkid': 3857, 'wkid': 102100},\n",
-    " 'xmax': -13038426.89338742,\n",
-    " 'xmin': -13237372.638884207,\n",
-    " 'ymax': 4065046.3578961184,\n",
-    " 'ymin': 3923105.9219285306})"
+    " 'xmin': -2357466.358090248,\n",
+    " 'ymin': 5398560.851584372,\n",
+    " 'xmax': 983749.0223104877,\n",
+    " 'ymax': 8333742.73773436})"
    ]
   },
   {
@@ -678,6 +716,16 @@
     "        )"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "15161ab6-eadb-40d3-97e1-7bbec5288a9a",
+   "metadata": {},
+   "source": [
+    "We have established above that a `Sidecar` is composed of slides, and each `SidecarSlide` is composed of two sub structures: a narrative panel and a media panel.\n",
+    "\n",
+    "Having defined our inputs above for the media_panel (Map) and navigation_panel (Map), let's now proceed to construct a `Sidecar` with one `SidecarSlide` using the classes from the ArcGIS API for Python."
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 109,
@@ -818,7 +866,9 @@
    "source": [
     "### Publish this StoryMap\n",
     "\n",
-    "To conclude this guide, we will now publish this story by setting `publish=True` in the `save()` function."
+    "To conclude this guide, we will now publish this story by setting `publish=True` in the `save()` function.\n",
+    "\n",
+    "> Note: While we have demonstrated the process to programmatically [`save()`](https://developers.arcgis.com/python/latest/api-reference/arcgis.apps.storymap.html#arcgis.apps.storymap.story.StoryMap.save) the StoryMap throughout this guide, it is strongly encouraged to view and verify the StoryMap in the UI and publish it there, especially for the first time you publish a StoryMap. "
    ]
   },
   {