SG misses classes that aren't imported

UPDATED:

Right now it seems like methods of classes will only be linked with backrefs if the class is imported somehow (e.g., import matplotlib.pyplot as plt; ax = plt.Axes() would I think properly link to any methods in ax such as ax.scatter).

However, sometimes there are objects which have examples in the docs, but are not explicitly imported in those examples. E.g., fig, ax = plt.subplots).

How should we handle these cases?

@Eric89GXL has proposed something like this:

Maybe a compromise would be to parse the non-code for statements in the that contain Sphinx references, like:

  This example makes use of :class:`mne.SourceEstimate`.

Then it’s clean RST format, and should/could link nicely?

[larsoner]

@Titan-C any comment on this starting here? This is a feature we still miss.

[choldgraf]

I agree w/ @Eric89GXL - Matplotlib would also have a huge benefit from improvements along these lines (e.g. SG isn’t detecting any of the methods called on Axes objects that are created with plt.subplots)