This seems OK, however, I think it significantly overlaps doc/index.html both conceptually and in content. Can we just add the example to doc/index.html and think of the front pages of the docs as the place where users "get started"?

• Current doc/index.html
• Proposed doc/users/getting_started.html

Can we [...] think of the front pages of the docs as the place where users "get started"?

From an audience point of view, getting_started addresses new users whereas index addresses all users. So the first is more specific and a subset of the second. If we integrate all new-user-relevant information on the main page, we have to make sure not to clutter it too much and by that reduce usability for other users. E.g. the example takes a lot of space but is irrelevant for all people who have used Matplotlib before. It could also well be that we want to add some more information target at new users. I've just created a very basic set, which may or may not be all we want to say to new users. Therefore I'm inclinded to keep the pages separate and focussed on the respective audinence even if that means some duplication.

I agree however, that there could be more refinement. I'd be open to remove the installation part from index and replace it with getting started. Installation in itself is not very valuable. Existing users don't need it. New users probably need more information to get productive (exactly what we want to write in getting_started).

I'm fine with that too. If we do this, can I suggest we make this doc/users/getting_started/index.html? and then we could add other "beginner" resources here?

Numpy: https://numpy.org/install/
Pandas: https://pandas.pydata.org/getting_started.html
xarray: http://xarray.pydata.org/en/stable/getting-started-guide/index.html

Sure.

Well we can do it in the rebase of the reorg. But @story645 is blocking 😀