I noticed that bokeh.plotting.figure.Figure.graph() documents its **kwargs parameters in the docstring, which is then built into the API reference docs by sphinx.
When I try to do this on my own project, sphinx complains:
WARNING: Inline literal start-string without end-string.
because reST specifies that asterisks in that form specify emphasis. Of course, a solution would be to escape the asterisks but then the docstring becomes less readable. How does bokeh.plotting.figure.Figure.graph() get away with it?
We do have specialized extensions for lots of various different things, e.g. our typed properties but we don’t do anything special with overriding function or method signatures.