Merge pull request #29 from UCSB-Library-Research-Data-Services/fix/14

Fix/14

Author: jairomelo

01_make_map.qmd

@@ -48,7 +48,7 @@ Sign on with your UCSB NetID. You may need to enter "ucsb" into the url
 box. Do not use the ArcGIS login! This is for users who do NOT have a
 UCSB Net ID.
 
-![](images/arcgis-login.png){width="40%" fig-align="center"}
+![ArcGIS Online login page for UCSB users](images/arcgis-login.png){width="40%" fig-align="center"}
 
 You should have a similar landing page indicating that you are using the
 ArcGIS online under the UCSB license. You may need to authenticate with
@@ -62,7 +62,7 @@ content published by users on your campus.
 
 Along the top of the page, is the main tool bar.
 
-![](images/main-menu-bar.png){width="90%" fig-align="center"}
+![ArcGIS Online main menu bar](images/main-menu-bar.png){width="90%" fig-align="center"}
 
 -   `Home` will take you to the main landing page when you first sign
     in.
@@ -89,7 +89,7 @@ Along the top of the page, is the main tool bar.
 
 Open a new, empty map by clicking "Map" on your top menu bar.
 
-![](images/new_empty_map.png){size="50%" fig-align="center"}
+![Opening a new empty map](images/new_empty_map.png){size="50%" fig-align="center"}
 
 ### Map main components
 
@@ -106,7 +106,7 @@ you can add items to your map.
 A new map will always open with a basemap. Esri has about 20 different
 basemaps available. We will start with the default.
 
-![](images/current-basemap.png){width="90%" fig-align="center"}
+![Default basemap](images/current-basemap.png){width="90%" fig-align="center"}
 
 Make sure you choose a basemap that is easy to follow and is a good
 reference. The default basemap layer in ArcGIS online is
@@ -139,8 +139,7 @@ personal experience as a bicyclist or pedestrian on campus.
 From the **Layers** panel, click on the add layer button. Search
 `My organization` for 'UCSB OSM Paths'. There should be only one result.
 
-![Adding a layer](images/add_a_layer.png){width="20%"}
-
+![Adding a layer](images/Workshop1/Step1/add-a-layer.gif){width="90%"}
 
 
 ::: {.callout-tip collapse="true" title="Challenge:
@@ -149,8 +148,7 @@ your map."}
 
 ### Import points layer (bike racks)
 
-![Add UCSB bike racks
-layer](images/Workshop1/Step1/select-feature-point-layer.png){width="90%"}
+![Add UCSB bike racks layer](images/Workshop1/Step1/select-feature-point-layer.png){width="90%"}
 
 :::
 
@@ -161,21 +159,41 @@ the `UCSB Campus Buildings` layer from there."}
 
 ### Add a layer via Groups
 
-![Add UCSB buildings
-layer](images/Workshop1/Step1/select-feature-polygon-layer.png){width="70%"}
+![Add UCSB buildings layer](images/Workshop1/Step1/select-feature-polygon-layer.png){width="90%"}
 
 :::
 
-## Accessing the underlying data
+### Reorder layers
+
+After importing the three layers, you'll notice they might not display optimally. There's a GIS convention for layer ordering that helps ensure all features remain visible:
+
+**Layer Order Convention (top to bottom):**
+
+- Points (e.g., bike racks) - should be on top
+- Lines (e.g., bike paths) - in the middle  
+- Polygons (e.g., buildings) - at the bottom
+
+This ordering ensures that smaller features aren't hidden beneath larger polygon areas.
+
+For our map, the recommended order from top to bottom should be:
+
+1.  `bike_racks_ucsb` (top)
+2.  `UCSB OSM Paths` (middle)
+3.  `UCSB Campus Buildings` (bottom)
+
+To reorder the layers, click and hold on a layer name in the Layers panel, drag it to the desired position, and release.
+
+![Reorder feature layers](images/Workshop1/Step1/reorder-layers.gif){width="90%" fig-align="center"}
+
+### Accessing the underlying data
 
 \* Feature layers \* are driven by data.
 Each point, line, or polygon has associated with it a row in an attribute table. 
 
 For example, if you click on the three dots on the right of a feature layer
 you can access their *attribute table* using "Show table".
 
-![attibute table of UCSB buildings
-layer](images/Workshop1/Step1/attribute-table.png){width="90%"}
+![Attribute table of UCSB buildings layer](images/Workshop1/Step1/attribute-table.png){width="90%"}
 
 We will see later how you can leverage these attributes to set the
 symbology of a layer according to categories or quantities provided by
@@ -189,17 +207,9 @@ Now that you have added the layers to your map, save it by looking for
 the folder icon in the left menu bar and then selecting the `Save as`
 option.
 
-![](images/Workshop1/Step1/save-as.png){width="40%" fig-align="center"}
+![Save as dialog in ArcGIS Online](images/Workshop1/Step1/save-as.png){width="40%" fig-align="center"}
 
-In there, you can add a title, tags, and a short description of your
-map.
-
-*Aside* Next to your campus profile, is a "tic tac toe" menu with a
-drop-down menu of the Esri Apps. There are many tools here, but for the
-context of this workshop, we will be focusing on ArcGIS Online and the
-Map Viewer.
-
-![](images/AGO-meatball-menu.png){width="90%" fig-align="center"}
+In there, you can add a title, tags, and a short description of your map.
 
 ## Step 2: Customize symbology & transparency
 
@@ -220,7 +230,7 @@ From the menu, we can select several categories of symbols. Let's select
 the `Government` category and look for a bike parking icon. Click on the
 `Done` button to apply the changes and return to the symbol style panel.
 
-![](images/Workshop1/Step2/symbology-select-symbol.png){width="90%"
+![Selecting a bike parking symbol from the Government category](images/Workshop1/Step2/symbology-select-symbol.png){width="90%"
 fig-align="center"}
 
 To change the size of the symbol, we can use the `Size` slider to reduce
@@ -233,7 +243,7 @@ our case, we selected 5.68 px.
 
 In ArcGIS Online, every time you select the "Adjust size automatically" option, it will reset the size slider to a default value. So make sure to select your desired size **after** enabling that option.
 
-![](images/Workshop1/Step2/symbology-point-size.png){width="70%"}
+![Symbol size settings with adjust size automatically option](images/Workshop1/Step2/symbology-point-size.png){width="70%"}
 :::
 
 
@@ -251,15 +261,13 @@ by changing the style of the `UCSB Campus Buildings` layer.
 -   Select the attribute `b_use`, which stands for building use, and
     click on `Add`.
 
-![](images/Workshop1/Step2/symbology-by-attribute.png){width="90%"
-fig-align="center"}
+![Adjusting symbology style by attribute](images/Workshop1/Step2/symbology-by-attribute.png){width="90%" fig-align="center"}
 
 As a result, you will see that the buildings are now filled with
 different colors based on their use. You can further customize the
 colors by clicking on the color ramp and selecting a different one.
 
-![](images/Workshop1/Step2/symbology-by-attribute-result.png){width="90%"
-fig-align="center"}
+![Buildings colored by their use category](images/Workshop1/Step2/symbology-by-attribute-result.png){width="90%" fig-align="center"}
 
 ::: {.callout-warning collapse="true" title="b_temp? b_phase"}
 
@@ -287,12 +295,12 @@ To increase the visibility of the bike paths, we can increase the width
 of the lines by editing the `Width` slider on the `Symbol style` panel.
 We selected 3.75 px for this example.
 
-![](images/Workshop1/Step2/symbology-transparency-by-attribute.png){width="90%"
+![Setting transparency by maxspeed attribute](images/Workshop1/Step2/symbology-transparency-by-attribute.png){width="90%"
 fig-align="center"}
 
 Here is the final result of our symbology adjustments:
 
-![](images/Workshop1/Step2/symbology-final-result.png){width="90%"
+![Map with all symbology adjustments applied](images/Workshop1/Step2/symbology-final-result.png){width="90%"
 fig-align="center"}
 
 ### Select a better basemap
@@ -302,14 +310,14 @@ almost ready map. However, the current basemap (Topographic) is a bit
 too busy and makes it hard to see the features we added. Let's change it
 to a simpler basemap using the `Basemap` option in the left menu bar.
 
-![](images/Workshop1/Step2/basemap-menu-location.png){width="40%"
+![Basemap option in the left menu bar](images/Workshop1/Step2/basemap-menu-location.png){width="40%"
 fig-align="center"}
 
 From the basemap gallery, we can select a simpler basemap. For this
 example, we selected the `Light Gray Canvas` basemap, which provides a
 clean background that makes our features stand out.
 
-![](images/Workshop1/Step2/basemap-light-gray-canvas.png){width="90%"
+![Map with Light Gray Canvas basemap](images/Workshop1/Step2/basemap-light-gray-canvas.png){width="90%"
 fig-align="center"}
 
 **Don't forget to save your map after making these changes!**
@@ -325,14 +333,15 @@ purposes here, though, we will take the more straightforward approach of
 simply drawing on the map. The hand-drawn features will appear in what
 ArcGIS Online calls a "sketch layer."
 
-![](images/Workshop1/Step3/drawing-sketch-layer-menu.png){width="40%"
+![Sketch layer option in the left menu](images/Workshop1/Step3/drawing-sketch-layer-menu.png){width="40%"
 fig-align="center"}
 
 After adding the sketch layer to your workspace, a new menu will appear
 in the right column with drawing tools and configuration options.
 
-![](images/Workshop1/Step3/drawing-sketch-bar-menu.png){width="40%"
-fig-align="center"}
+![Sketch layer drawing tools menu](images/Workshop1/Step3/drawing-sketch-bar-menu.png){width="40%" fig-align="center"}
+
+### Drawing points in a sketch layer
 
 -   Draw points where you were in a (near-)accident on a bike path,
     either as bicyclist of pedestrian.
@@ -346,17 +355,17 @@ In our example, we add the following settings to the point symbol:
 -   Size: 48 px
 -   Vector marker (background): Blue (#2132cf)
 
-![](images/Workshop1/Step3/drawing-point-vector.png){width="90%"
-fig-align="center"}
+![Point symbol customization settings](images/Workshop1/Step3/drawing-point-vector.png){width="90%" fig-align="center"}
+
+### Challenge: Drawing lines and circles in a sketch layer
 
 -   Draw a line where you think there should be a bike path but isn't.
 
 From the sketch layer menu, select the line drawing tool. Click on the
 map to start drawing the line, and click again to add vertices.
 Double-click to finish the line.
 
-![](images/Workshop1/Step3/drawing-line-vector.gif){width="90%"
-fig-align="center"}
+![Drawing a line on the map](images/Workshop1/Step3/drawing-line-vector.gif){width="90%" fig-align="center"}
 
 You can customize the line symbol in the sketch layer menu before adding
 it to the map. In our example, we add the following settings to the line
@@ -366,8 +375,7 @@ symbol:
 -   Dotted line pattern
 -   Color: Light blue (#00c8ff)
 
-![](images/Workshop1/Step3/drawing-line-style.png){width="90%"
-fig-align="center"}
+![Line symbol customization settings](images/Workshop1/Step3/drawing-line-style.png){width="90%" fig-align="center"}
 
 -   Draw a circle where you think there should be a bike parking lot but
     isn't.
@@ -382,7 +390,7 @@ circle symbol:
 -   Fill color: Red (#d13434)
 -   Fill transparency: 38%
 
-![](images/Workshop1/Step3/drawing-circle-vector.gif){width="90%"
+![Drawing a circle on the map](images/Workshop1/Step3/drawing-circle-vector.gif){width="90%"
 fig-align="center"}
 
 -   Rename the Sketch layer to "Annotations"
@@ -410,7 +418,7 @@ layer to reduce visual clutter.
 To do that, you need to look for the `Print` option in the left menu
 bar.
 
-![](images/Workshop1/Step4/export-print-menu.png){width="40%"
+![Print option in the left menu bar](images/Workshop1/Step4/export-print-menu.png){width="40%"
 fig-align="center"}
 
 For exporting the map you have two options:
@@ -440,7 +448,7 @@ and select to include legend, north arrow, and scale bar.
 Adjust the zoom and position of the map in the preview window to ensure
 everything is visible and well-framed.
 
-![](images/Workshop1/Step4/export-layout-menu.png){width="90%"
+![Map export layout configuration panel](images/Workshop1/Step4/export-layout-menu.png){width="90%"
 fig-align="center"}
 
 ## Step 5: Share your map
@@ -453,15 +461,15 @@ The result will be list on the `Exports` panel, where you can save the
 file to your computer by clicking on the three dots next to the export
 and selecting `Save as`.
 
-![](images/Workshop1/Step4/export-save-as.png){width="40%"
+![Saving exported map from the Exports panel](images/Workshop1/Step4/export-save-as.png){width="40%"
 fig-align="center"}
 
 This will save the exported map to you ArcGIS Online content. You can
 access it later from the `Content` menu in the top menu bar. The new
 item will be available as an Image file that you can download to your
 computer.
 
-![](images/Workshop1/Step4/export-download-image.png){width="90%"
+![Downloading the exported map image from ArcGIS Online content](images/Workshop1/Step4/export-download-image.png){width="90%"
 fig-align="center"}
 
 **NOTE**: Public sharing is a little more complicated, it requires to