Documentation Link

https://matplotlib.org/devdocs/api/_as_gen/matplotlib.pyplot.figure.html

Problem

Suppose you have constrained layout turned on in general via rcParams, but want to not use it for a particular figure. This seems to work

import matplotlib.pyplot as plt

plt.rcParams["figure.constrained_layout.use"] = True
fig = plt.figure(layout="none")
print(fig.get_layout_engine())

None

but layout="none" is not documented as a valid option in either pyplot.figure or the Figure constructor.

Suggested improvement

Should layout="none" be documented as a valid option?