"getting started icon"

[d-v-b]

I'm not a fan of the icon over the "getting started" section of the docs landing page, it conveys "running away from danger" to me much more than "getting started with something":

IMO the text "getting started" alone is sufficient, and so we could just remove that icon entirely. Any thoughts?

[jhamman]

I don't think this is a big deal. You'll find that same icon in a number of places around the ecosystem:

• https://docs.xarray.dev/en/stable/index.html
• https://pandas.pydata.org/docs/

Certainly open to replacing the icon but doesn't seem like much of a priority to me.

[d-v-b]

I find that icon is weird in all those other places too. But I do think my bigger objection is to the layout itself -- "getting started" is actually the job of the main page and so I don't think it needs its own category. Also, I don't think the other categories should be displayed in a grid, each with their own large icons, etc. I agree that it's not a big priority right now, but I would very much support restructuring our docs to be organized more like pydantic's

[jhamman]

Just a quick note to mention that all of these sites are attempting to follow the Diátaxis framework: https://diataxis.fr/

Not saying we're doing it super well but that is the origin for this layout.

[d-v-b]

i think the diataxis idea is great insofar as it suggest 4 categories of content to have on our docs, but centerpiecing those 4 categories as links on the main page seems like a wonky implementation -- not even the diataxis site itself does this (it only displays the categories as an image)