search

plotly / documentation

Issue tracker for Plotly's open-source documentation.
421 stars 551 forks source link

switch version in the api docs #1691

Open s-cork opened 2 years ago

s-cork commented 2 years ago

Is there a way to switch version in the api docs?

https://plotly.com/python-api-reference seems to be at 5.1.0. And there seems no way to see the api docs for a different version. It would be useful for those that haven't yet migrated.

nicolaskruchten commented 2 years ago

There is not, no, but our API is largely backwards-compatible back to 3.0 with only the changes listed in https://plotly.com/python/v4-migration/

s-cork commented 1 year ago

I wanted to re-open this. Context - we currently use python version 4, and are often a version behind plotly latest.

Whilst being largely backward compatible is useful. Not having access to api docs of previous versions can be frustrating at times.

For example, a user just pointed out that fillpattern doesn't work in our plotly implementation. This is documented in the API docs. But there's no obvious place I can point the user to and say:

Having a version switch in the website documentation would be so helpful for this kind of use case.