Versioned documentation (have new plotly express docs overwritten old api docs?)

📊 Plotly Python
5

Hi @felixvelariusbos, unfortunately we’re actually going in the other direction with our v3 (v2 compatible) docs and we plan on getting rid of them in the future.

So if you plan on continuing to use and update v2/v3 of plotly.py, I would recommend looking over https://plotly.com/python/creating-and-updating-figures/ which may help you to convert the V4 style of creating charts that we recommend and use in the new docs to the older V3-compatible style.

Essentially that boils down to not being able to use the graph_objects update_* methods and the new magic underscore syndax so you’ll have to convert something like this:

import plotly.graph_objects as go
fig = go.Figure(data=go.Bar(x=[1, 2, 3], y=[1, 3, 2]))
fig.update_layout(title_text="A Bar Chart",
                  title_font_size=30)
fig.show()

to

import plotly.offline as py
data = [go.Bar(x=[1, 2, 3], y=[1, 3, 2]))]
layout = dict(
        title="A Bar Chart",
        titlefont=dict(size=30)
    )
)
fig = dict(data=data, layout=layout)
py.iplot(fig)

I.e you’ll need to replace underscores with nested dicts and you’ll have to explicitly create a layout object. Additionally, you will need to know that we changed the layout attribute titlefont to font as a subattribute of a new title object attribute (see this PR for more details about that change). This process will work for 90% of the non-plotly-express examples in the new docs