imshow examples, plus minor edits

Author: LiamConnors

doc/python/annotated-heatmap.md

@@ -5,10 +5,10 @@ jupyter:
     text_representation:
       extension: .md
       format_name: markdown
-      format_version: '1.1'
-      jupytext_version: 1.1.1
+      format_version: '1.3'
+      jupytext_version: 1.13.4
   kernelspec:
-    display_name: Python 3
+    display_name: Python 3 (ipykernel)
     language: python
     name: python3
   language_info:
@@ -20,7 +20,7 @@ jupyter:
     name: python
     nbconvert_exporter: python
     pygments_lexer: ipython3
-    version: 3.6.7
+    version: 3.7.11
   plotly:
     description: How to make Annotated Heatmaps in Python with Plotly.
     display_as: scientific
@@ -34,9 +34,52 @@ jupyter:
     thumbnail: thumbnail/ann_heat.jpg
 ---
 
-#### Simple Annotated Heatmap
+### Annotated Heatmaps with plotly.express and px.imshow
+
+
+These examples use [px.imshow](/python/imshow) to create Annotated Heatmaps. px.imshow is the best way creating heatmaps with z-annotations.
+
+
+#### Basic Annotated Heatmap for z-annotations
+
+
+After creating a figure with `px.imshow`, you can add z-annotations with `.update_traces(texttemplate="%{z}")`.
+
+```python
+import plotly.express as px
+
+df = px.data.medals_wide(indexed=True)
+
+fig = px.imshow(df)
+fig.update_traces(texttemplate="%{z}")
+
+fig.show()
+```
+
+#### Custom Font
+
+
+You can make changes to the font using `textfont`. Here we set the font size to 20.
 
-This page details the use of a [figure factory](/python/figure-factories/). For more examples with Heatmaps, see [this page](/python/heatmaps/).
+```python
+import plotly.express as px
+
+df = px.data.medals_wide(indexed=True)
+
+fig = px.imshow(df)
+fig.update_traces(texttemplate="%{z}")
+fig.update_traces(textfont={"size":20})
+
+fig.show()
+```
+
+### Annotated Heatmaps with [figure factory](/python/figure-factories/). For more examples with Heatmaps, see [this page](/python/heatmaps/).
+
+
+The remaining examples show how to create Annotated Heatmaps with [figure factory](/python/figure-factories/). For more examples with Heatmaps, see [this page](/python/heatmaps/).
+
+
+#### Simple Annotated Heatmap
 
 ```python
 import plotly.figure_factory as ff
@@ -201,6 +244,12 @@ fig.update_layout(title_text='Periodic Table')
 fig.show()
 ```
 
+#### Annotations with plotly.express
+
+```python
+
+```
+
 #### Reference
 
 For more info on Plotly heatmaps, see: https://plotly.com/python/reference/heatmap/.<br> For more info on using colorscales with Plotly see: https://plotly.com/python/heatmap-and-contour-colorscales/ <br>For more info on `ff.create_annotated_heatmap()`, see the [full function reference](https://plotly.com/python-api-reference/generated/plotly.figure_factory.create_annotated_heatmap.html#plotly.figure_factory.create_annotated_heatmap)

doc/python/colorscales.md

@@ -521,7 +521,7 @@ fig.show()
 ### Color Bar Displayed Horizontally
 
 
-By default, color bars are displayed vertically. You can change a color bar to be displayed horizontally by setting `orientation`=`h`.
+By default, color bars are displayed vertically. You can change a color bar to be displayed horizontally by setting the `colorbar` `orientation` attribute to `h`.
 
 ```python
 import plotly.graph_objects as go
@@ -539,17 +539,7 @@ fig = go.Figure()
 
 fig.add_trace(go.Heatmap(
     z=dataset["z"],
-    colorbar=dict(
-        title="Surface Heat",
-        titleside="top",
-        tickmode="array",
-        tickvals=[2, 50, 100],
-        ticktext=["Cool", "Mild", "Hot"],
-        ticks="outside",
-        orientation='h'
-        
-    )
-))
+    colorbar=dict(orientation='h')))
 
 fig.show()
 ```

doc/python/heatmaps.md

@@ -216,7 +216,7 @@ fig.show()
 ### Text on Heatmap Points
 
 
-In this example we add text to heatmap points using `texttemplate`. We use the values from the `text` attribute for the text. We also adjust the font size using `textfont`.
+In this example we add text to heatmap points using `texttemplate`. We use the values of the `text` attribute for the text. We also adjust the font size using `textfont`.
 
 ```python
 import plotly.graph_objects as go

doc/python/histograms.md

@@ -362,9 +362,7 @@ fig.show()
 ### Histogram Bar Text
 
 
-You can add text to histogram bars using the `texttemplate` argument. In this example we add the x-axis values as  text following the format `%{variable}`. We also adjust the size of the text using `textfont_size`.
-
-
+You can add text to histogram bars using the `texttemplate` argument. In this example we add the x-axis values as text following the format `%{variable}`. We also adjust the size of the text using `textfont_size`.
 
 ```python
 import plotly.graph_objects as go

doc/python/imshow.md

@@ -5,10 +5,10 @@ jupyter:
     text_representation:
       extension: .md
       format_name: markdown
-      format_version: '1.2'
-      jupytext_version: 1.4.2
+      format_version: '1.3'
+      jupytext_version: 1.13.4
   kernelspec:
-    display_name: Python 3
+    display_name: Python 3 (ipykernel)
     language: python
     name: python3
   language_info:
@@ -20,7 +20,7 @@ jupyter:
     name: python
     nbconvert_exporter: python
     pygments_lexer: ipython3
-    version: 3.7.7
+    version: 3.7.11
   plotly:
     description: How to display image data in Python with Plotly.
     display_as: scientific