I think I am not in favor of the proposal as currently written. Our current User Guide seems (to me) similar in scope to those of other projects (in particular, projects with good docs that we might want to emulate):

• SciPy: https://docs.scipy.org/doc/scipy/tutorial/index.html
• NumPy: https://numpy.org/doc/stable/user/index.html
• Astropy: https://docs.astropy.org/en/stable/index_user_docs.html

So I don't think I'm in favor of splitting off some pages into a new Learning section alongside the current User Guide.

However, I do like what NumPy and Astropy have done with organizing the User Guide into subsections. @RDaxini could we adapt your proposal to use subsections in the User Guide rather than creating a new top-level section?

I think I am not in favor of the proposal as currently written. Our current User Guide seems (to me) similar in scope to those of other projects (in particular, projects with good docs that we might want to emulate):

• SciPy: https://docs.scipy.org/doc/scipy/tutorial/index.html
• NumPy: https://numpy.org/doc/stable/user/index.html
• Astropy: https://docs.astropy.org/en/stable/index_user_docs.html

So I don't think I'm in favor of splitting off some pages into a new Learning section alongside the current User Guide.

However, I do like what NumPy and Astropy have done with organizing the User Guide into subsections. @RDaxini could we adapt your proposal to use subsections in the User Guide rather than creating a new top-level section?

Fair comment, good suggestion. I'll work up a draft structure for user guide subsections later and, if approved, I will just work it into the existing PR (#2310)
Anyone feel free to suggest a structure too if you like

I think a modified version of the numpy.org structure would serve us well here:

Getting started
Package Overview
Installation
Intro Tutorial
Advanced usage
ModelChain
Time and time zones
Clear sky
Bifacial modeling
Weather data
Single Diode Equation
Extras
Variables and Symbols
Frequently Asked Questions