Wishlist: doc examples wanted

[emmanuelle]

Most items coming from questions on the community forum

• a proper multicategory bar example based on https://community.plotly.com/t/multicategory-axis-type-example/26392
• example of shape or annotation covering several subplots thanks to xref='paper'. Also the shapes and annotations tutorial should link to each other.
• orthographic projection example in 3d axes tutorial (or 3d camera controls)
• improve explanations on updatemenus and changing animation speed in animations. See https://stackoverflow.com/questions/59070876/plotly-how-do-the-buttons-for-the-update-menus-really-work/59076340#59076340, https://community.plot.ly/t/scatter-animation-doesnt-work/31944 https://community.plot.ly/t/need-animation-example-with-scattermapbox/9720/10 https://community.plot.ly/t/how-to-slow-down-animation-in-plotly-express/31309/7
• in slider page https://plot.ly/python/sliders/, add example using the update method (modifying both traces and layout), as in the buttons tutorial https://plot.ly/python/custom-buttons/, and also an example using relayout. Discussed in https://community.plot.ly/t/update-plot-with-restyle-method-get-the-current-selected-slider-value/36162/4.
• example using px.strip, see https://community.plotly.com/t/make-a-violin-plot-with-only-points/37412/3. In box plot page, and add a link also in violin page.
• example of sparkline in scatter and line page. See this community post.
• example using surfacecolor in 3d surface tutorial. See this community post.
• example of how to use go.Frame to target only certain traces in updates Underlying plot data dissapears when animation frames are added #2423 (comment)
• example of how to use mapbox sourceattribution
• example of update_scenes and clarity on how update_xaxes is 2d only Updating layout of specific subplot  #2483 ... similarly let's ensure there's an example somewhere in the docs for every update method: polar, ternary etc
• we need an example of append_trace somewhere, even just to say it's equivalent to add_trace except that it doesn't return the figure (for... reasons?)
• would be nice to have a demo of a facet grid map like this one:
  

[emmanuelle]

I've tagged this issue as a good first issue since some examples are quite easy to add (especially if the forum posts have some code examples). Items which have already been ticked are already done. Feel free to ask questions here if you would like to contribute an example but are unsure about how to do it. Please also refer to the doc README https://github.com/plotly/plotly.py/blob/master/doc/README.md

[emmanuelle]

Here is also a couple of searches with no result on the doc website, which should return something

• lasso and box selection (we do have a page for selection-events but it's for FigureWidget, we don't have anything for selections in plotly figures I believe, only in the config page maybe)
• io
• modebar
• various figure factory names (create_gantt, create_distplot, create_trisurf)
• drilldown (to be added to sunburst and treemap)
• figsize (this is the matplotlib parameter, we might mention in when talking about the width and height of a figure).

[SylwiaOliwia2]

I can help with that (I have experience with Plotly, but it's my first Open Source contribution). Are some of the tasks in progress? Or I can pick any that is not done?

[emmanuelle]

Thank you @SylwiaOliwia2! I've updated the list by ticking contributions in progress, it was indeed not completely up to date :-). You can also write here on which example you would like to work on, or tick the corresponding box so that we know you're working on it. Thanks again :-)

[SylwiaOliwia2]

I'll start with the following:

• add coloraxis example to the subplots tutorial - Pull request Update subplots.md #2226
• example with legend only for a trace - Pull request Update legend.md #2227
• add an example with matching axes (matches="x")
• on histogram tutorial, mention that we cannot access the values of counts (it's asked a lot), and maybe mention numpy's function for this. Update histograms.md #2242

I'll keep updating this post about the tasks resolved by me.