Update deck.md (#3653)

bindings/python/pydeck/docs/deck.md

@@ -9,7 +9,10 @@ class pydeck.*Deck*(
     views=[pydeck.View()],
     map_style="mapbox://styles/mapbox/dark-v9",
     mapbox_key=None, 
-    initial_view_state=pydeck.ViewState()
+    initial_view_state=pydeck.ViewState(),
+    height=500,
+    width='100%',
+    tooltip=True,
 )
 ```
 
@@ -19,23 +22,43 @@ Requires a Mapbox API token to display a basemap, see notes below.
 
 #### Parameters
 
-`layers` : `pydeck.Layer` or list of pydeck.Layer`, default `[]`
-    pydeck.Layer objects to render
+- `layers` : `pydeck.Layer` or `list` of `pydeck.Layer`, default `[]`
 
-`views` : `list` of `pydeck.View`, default `[pydeck.View()]`
-    List of `pydeck.View` objects to render. If rendering a standard map, there is rarely a reason to modify this.
+Layers of the map (represented by `pydeck.Layer` objects) to be rendered
 
-`map_style` : `str`, default `"mapbox://styles/mapbox/dark-v9"`
-    URI for Mapbox basemap style
+- `views` : `list` of `pydeck.View`, default `[pydeck.View()]`
+
+List of `pydeck.View` objects to render. If rendering a standard map, there is rarely a reason to modify this.
+
+- `map_style` : `str`, default `"mapbox://styles/mapbox/dark-v9"`
+
+URI for Mapbox basemap style
+
+- `mapbox_key` : `str`, default `None`
+
+Read on initialization from the MAPBOX_API_KEY environment variable. Defaults to None if not set.
+If not using a basemap, you can set this value to `None`.
+See https://docs.mapbox.com/help/how-mapbox-works/access-tokens/#mapbox-account-dashboard
+
+- `initial_view_state` : `pydeck.ViewState`, default `pydeck.ViewState()`
+
+ Initial camera angle relative to the map, defaults to a fully zoomed out 0, 0-centered map with 0 pitch and bearing
+ To compute a viewport from data, see `pydeck.data_utils.compute_viewport`
+
+- `height` : `int` or `str`, default `500`
+
+Height of visualization, in pixels (if a number) or as a CSS value string
+
+- `width` : `int` or `str`, default `100%`
+
+Width of visualization, in pixels (if a number) or as a CSS value string
+
+- `tooltip` : `bool`, default `True`
+
+Boolean indicating whether or not a tooltip should be generated when hovering over a data layer
+Individual layers must have `pickable` set to `True` to be displayed in the tooltip.
 
-`mapbox_key` : `str`, default None
-    Read on initialization from the MAPBOX_API_KEY environment variable. Defaults to None if not set.
-    If not using a basemap, you can set this value to `None`.
-    See https://docs.mapbox.com/help/how-mapbox-works/access-tokens/#mapbox-account-dashboard
 
-`initial_view_state` : `pydeck.ViewState`, default `pydeck.ViewState()`
-    Initial camera angle relative to the map, defaults to a fully zoomed out 0, 0-centered map with 0 pitch and bearing
-    To compute a viewport from data, see `pydeck.data\_utils.compute\_viewport`
 
 ## pydeck.Deck.show
 
@@ -51,12 +74,7 @@ Displays current Deck object for a Jupyter notebook
 pydeck.Deck.update(self)
 ```
 
-Updates a deck.gl map to reflect the current state of the configuration.
-
-For example, if you've modified data passed to Layer and rendered the map using `.show()`,
-you can call `update` to pass the new configuration to the map.
-
-Intended for use in a Jupyter notebook.
+Updates a deck.gl map to reflect the current state of the configuration. For example, if you've changed the color or height of a pydeck Layer, you can render the changes in Jupyter, without re-rendering your window. This function only works in a Jupyter environment.
 
 ## pydeck.Deck.to\_html
 
@@ -69,6 +87,7 @@ pydeck.Deck.to_html(
     iframe_width=500,
     iframe_height=500)
 ```
+
 Writes a file and loads it to an iframe, if `notebook\_display` is set to `True`.
 Otherwise, writes a file and optionally opens it in a web browser.
 
@@ -79,23 +98,29 @@ not render.
 
 #### Parameters
 
-`filename` : `str`, default `None`
-    Name of the file. If no name is provided, a randomly named file will be written locally.
+- `filename` : `str`, default `None`
+
+Name of the file. If no name is provided, an .html file with the prefix `pydeck` will be written locally.
 
-`open_browser` : `bool`, default `False`
-    Whether to open the visualization in a browser after execution.
+- `open_browser` : `bool`, default `False`
 
-`notebook_display` : `bool`, default `True`
-    Attempts to display the HTML output in an iframe if True. Only works in a Jupyter notebook.
+Whether to open the visualization in a browser after execution.
+
+- `notebook_display` : `bool`, default `True`
+
+Attempts to display the HTML output in an iframe if True. Only works in a Jupyter notebook.
 
 `iframe_width` : `int`, default `500`
-    Height of Jupyter notebook iframe in pixels, if rendered in a Jupyter notebook.
+
+Height of Jupyter notebook iframe in pixels, if rendered in a Jupyter notebook.
 
 `iframe_height` : `int`, default `500`
-    Width of Jupyter notebook iframe in pixels, if rendered in a Jupyter notebook.
+
+Width of Jupyter notebook iframe in pixels, if rendered in a Jupyter notebook.
 
 #### Returns
-    `str` : A string path to the HTML file
+
+`str` : A string path to the HTML file
 
 #### Examples