Hello! I teach Plotly in one of my classes, and as I was reading through this documentation, I felt it could be more explicit about how data is passed into the different plotting functions.

Thanks!

Documentation PR

• I've seen the doc/README.md file
• This change runs in the current version of Plotly on PyPI and targets the doc-prod branch (削除) OR it targets the main branch (削除ここまで)
• (削除) If this PR modifies the first example in a page or adds a new one, it is a px example if at all possible (削除ここまで)
• (削除) Every new/modified example has a descriptive title and motivating sentence or paragraph (削除ここまで)
• (削除) Every new/modified example is independently runnable (削除ここまで)
• (削除) Every new/modified example is optimized for short line count and focuses on the Plotly/visualization-related aspects of the example rather than the computation required to produce the data being visualized (削除ここまで)
• (削除) Meaningful/relatable datasets are used for all new examples instead of randomly-generated data where possible (削除ここまで)
• (削除) The random seed is set if using randomly-generated data in new/modified examples (削除ここまで)
• (削除) New/modified remote datasets are loaded from https://plotly.github.io/datasets and added to https://github.com/plotly/datasets (削除ここまで)
• (削除) Large computations are avoided in the new/modified examples in favour of loading remote datasets that represent the output of such computations (削除ここまで)
• (削除) Imports are plotly.graph_objects as go / plotly.express as px / plotly.io as pio (削除ここまで)
• (削除) Data frames are always called df (削除ここまで)
• (削除) fig = <something> call is high up in each new/modified example (either px.<something> or make_subplots or go.Figure) (削除ここまで)
• (削除) Liberal use is made of fig.add_* and fig.update_* rather than go.Figure(data=..., layout=...) in every new/modified example (削除ここまで)
• (削除) Specific adders and updaters like fig.add_shape and fig.update_xaxes are used instead of big fig.update_layout calls in every new/modified example (削除ここまで)
• (削除) fig.show() is at the end of each new/modified example (削除ここまで)
• (削除) plotly.plot() and plotly.iplot() are not used in any new/modified example (削除ここまで)
• (削除) Hex codes for colors are not used in any new/modified example in favour of these nice ones (削除ここまで)