Restructure user guide with subsections

[RDaxini]

• Closes Restructure the user guide with subsections #2302
• I am familiar with the contributing guidelines
• Tests added
• Updates entries in docs/sphinx/source/reference for API changes.
• Adds description and name entries in the appropriate "what's new" file in docs/sphinx/source/whatsnew for all changes. Includes link to the GitHub Issue with :issue:`num` or this Pull Request with :pull:`num`. Includes contributor name and/or GitHub username (link with :ghuser:`user`).
• New code is fully documented. Includes numpydoc compliant docstrings, examples, and comments where necessary.
• Pull request is nearly complete and ready for detailed review.
• Maintainer: Appropriate GitHub Labels (including remote-data) and Milestone are assigned to the Pull Request and linked Issue.

#2302 for discussion

[RDaxini]

--edit: objective changed. See linked issue for discussion
Ready for an initial review

One observed limitation: visible main header section titles is currently limited to five headers, so the last one is now kept under "more"
Can this maximum be changed?
If not, I suggest swapping the order of "whatsnew" and "contributing". Having whatsnew at the end seems more intuitive to me, so I'd like to suggest this anyway even if all sections are listed upfront (no "more" list)

[kandersolar]

@RDaxini if you merge main into this PR to bring in #2332 I think the RTD build will start working again

[RDaxini]

@kandersolar sure np I remember 😅 you're too fast 😂

[RDaxini]

Ready for review again! Docs: https://pvlib-python--2310.org.readthedocs.build/en/2310/user_guide/index.html

[kandersolar]

This looks great!

Would it make sense to get rid of index.rst and have the User Guide link go straight to Package Overview?

[RDaxini]

Would it make sense to get rid of index.rst and have the User Guide link go straight to Package Overview?

In my view, it's not a bad idea and it'd probably work fine for me personally. The downside I see is for users who navigate by, or like to view, the subsubsections of each subsection. This makes me lean slightly away from the directing straight to package overview, but do many people navigate/view or docs like this...?

[RDaxini]

Is the question about index.rst currently holding up this PR? Do we need more reviews? I'm happy to go with the suggestion if it's required for this to be merged. As mentioned, I see the benefit, but just was not sure whether it'd be universally beneficial for all.

[cwhanse]

I mildly prefer keeping index.rst.

I think this PR is good to merge as is.

[kandersolar]

Thanks @RDaxini!