class methods do not have doc pages

Describe the bug Many PVSystem class methods do not have doc pages.

To Reproduce Go to the PVSystem doc page, notice that many methods don’t have links.

Versions:

• pvlib.__version__: 0.8.0b0

A of couple of approaches to consider:

Might try adding sphinx 3.1 :recursive: option here. There’s some compatibility reason we’re on an older version of sphinx (maybe a sphinx gallery issue?).

Modify the sphinx autosummary class template.

Manually document the methods in api.rst. We should be doing this anyways.

[kanderso-nrel]

There’s some compatibility reason we’re on an older version of sphinx (maybe a sphinx gallery issue?).

See https://github.com/pvlib/pvlib-python/issues/911#issuecomment-591233524, it was because of poor formatting in the sphinx 2.x html output and nuisance warnings. Looks like a lot of development has gone into Sphinx since February, so if we want to start using sphinx features added after 1.8.5, it’s probably worth trying out the current release again!

[cwhanse]

Duplicate links don’t bother me. If someone is looking up a method, they may be asking “what can I do with PVSystem” or they could be asking “what are the options for the _____ model”?

If I understand correct, we either add :recursive: where a Class appears in api.rst, or, we add an line for every class method. Either one would be maintainable for those who need a pattern to follow.