minor changes

Author: emmanuelle

python/images.md

@@ -37,7 +37,7 @@ jupyter:
 
 #### Add a Background Image
 
-In this page we explain how to add static, non-interactive images as background, logo or annotation images to a figure. For exploring image data in interactive charts, see the [tutorial on displaying image data](./imshow/).
+In this page we explain how to add static, non-interactive images as background, logo or annotation images to a figure. For exploring image data in interactive charts, see the [tutorial on displaying image data](/python/imshow).
 
 ```python
 import plotly.graph_objects as go
@@ -51,8 +51,7 @@ fig.add_trace(
 )
 
 # Add images
-fig.update_layout(
-    images=[
+fig.add_layout_image(
         go.layout.Image(
             source="https://images.plot.ly/language-icons/api-home/python-logo.png",
             xref="x",
@@ -64,7 +63,6 @@ fig.update_layout(
             sizing="stretch",
             opacity=0.5,
             layer="below")
-    ]
 )
 
 # Set templates
@@ -117,14 +115,14 @@ fig.add_trace(
 )
 
 # Add image
-fig.update_layout(
-    images=[dict(
+fig.add_layout_image(
+    dict(
         source="https://raw.githubusercontent.com/cldougl/plot_images/add_r_img/vox.png",
         xref="paper", yref="paper",
         x=1, y=1.05,
         sizex=0.2, sizey=0.2,
         xanchor="right", yanchor="bottom"
-    )],
+    )
 )
 
 # update layout properties
@@ -176,30 +174,26 @@ for (x, y), n in zip(simulated_absorptions, names):
     fig.add_trace(go.Scatter(x=x, y=y, name=n))
 
 # Add images
-fig.update_layout(
-    images=[go.layout.Image(
+fig.add_layout_image(
+    go.layout.Image(
         source="https://raw.githubusercontent.com/michaelbabyn/plot_data/master/benzene.png",
-        xref="paper",
-        yref="paper",
         x=0.75,
         y=0.65,
-        sizex=0.3,
-        sizey=0.3,
-        xanchor="right",
-        yanchor="bottom"
-    ), go.layout.Image(
+    ))
+fig.add_layout_image(go.layout.Image(
         source="https://raw.githubusercontent.com/michaelbabyn/plot_data/master/naphthalene.png",
-        xref="paper",
-        yref="paper",
         x=0.9,
         y=0.3,
+        )
+)
+fig.update_layout_images(dict(
+        xref="paper",
+        yref="paper",
         sizex=0.3,
         sizey=0.3,
         xanchor="right",
         yanchor="bottom"
-        )
-    ]
-)
+))
 
 # Add annotations
 fig.update_layout(
@@ -282,8 +276,8 @@ fig.update_yaxes(
 )
 
 # Add image
-fig.update_layout(
-    images=[go.layout.Image(
+fig.add_layout_image(
+    go.layout.Image(
         x=0,
         sizex=img_width * scale_factor,
         y=img_height * scale_factor,
@@ -293,7 +287,7 @@ fig.update_layout(
         opacity=1.0,
         layer="below",
         sizing="stretch",
-        source="https://raw.githubusercontent.com/michaelbabyn/plot_data/master/bridge.jpg")]
+        source="https://raw.githubusercontent.com/michaelbabyn/plot_data/master/bridge.jpg")
 )
 
 # Configure other layout

python/imshow.md

@@ -37,6 +37,10 @@ jupyter:
     v4upgrade: true
 ---
 
+This tutorial shows how to display and explore image data. If you would like
+instead a logo or static image, use `go.layout.Image` as explained
+[here](/python/images).
+
 ### Displaying RBG image data with px.imshow
 
 `px.imshow` displays multichannel (RGB) or single-channel ("grayscale") image data.
@@ -73,7 +77,7 @@ fig.show()
 
 ### Display single-channel 2D image as grayscale
 
-For a 2D image, `px.imshows` uses a colorscale to map scalar data to colors. The default colorscale is `gray`, ie grayscale images. 
+For a 2D image, `px.imshow` uses a colorscale to map scalar data to colors. The default colorscale is `gray`, ie grayscale images. 
 
 ```python
 import plotly.express as px
@@ -85,7 +89,6 @@ fig.show()
 
 ### Choose the colorscale to display a single-channel image
 
-For a 2D image, `px.imshows` uses a colorscale to map scalar data to colors. The default colorscale is `gray`, ie grayscale images.
 
 ```python
 import plotly.express as px
@@ -97,9 +100,9 @@ fig.show()
 
 ### Display multichannel image data with go.Image
 
-It is also possible to use the `go.Image` trace from the low-level `graph_objects` API in order to display image data. Note that `go.Image` only accepts multichannel images. For single images, use [`go.Heatmap`](https://plot.ly/python/heatmaps/).
+It is also possible to use the `go.Image` trace from the low-level `graph_objects` API in order to display image data. Note that `go.Image` only accepts multichannel images. For single images, use [`go.Heatmap`](/python/heatmaps).
 
-Note that the `go.Image` trace is different from the `go.layout.Image` class, which can be used for [adding background images or logos to figures](./images/). 
+Note that the `go.Image` trace is different from the `go.layout.Image` class, which can be used for [adding background images or logos to figures](/python/images). 
 
 ```python
 import plotly.graph_objects as go