godotengine
Redesign homepage into a landing page for various user profiles (old)
The landing page was simplified and now points to several home pages. This is based on what we discussed in Godot Sprint in early June.
The navigation in this PR is already functional, but it needs visual tweaks before it can be merged. The exact pages that are linked to are also subject to discussion – I've picked the choices that seem the most logical to me, but maybe we need extra landing pages (or fewer landing pages, in fact).
Preview
TODO
- [ ] Organize tutorials index to be more visually attractive (add images for each section). The same could perhaps be done for the Contributing page.
- [ ] Improve visual design of the homepage cards (add some icons?) and update it to work with a light theme. Tweak hover feedback to make more sense for a card.
- [ ] Fix "document isn't included in any toctree" error messages for
tutorials/indexandcontributing/index. I can't use Sphinx refs to link to those pages as they're only linked within raw HTML.
How about adding images instead of icons to the homepage cards? Could look something like this:
The images represent different topics or states of expertise, like the empty editor for absolute beginners or a screenshot of the engine's source code for potential engine contributors. Doesn't look too great in dark mode though. Maybe the highlight colors as well as the screenshots need to be adjusted for bright and dark page backgrounds.
I've reworked the Tutorials section listing to use images (the section you get to by clicking the 3rd blue tile). Only one image is used so far, but you get the idea:
Unfortunately, we don't have space to use a 2-column design to make the list shorter unless we get rid of the descriptions entirely (which help make the page feel less sterile).
The same could be applied to the Contributing section as well (the section you get to by clicking the 4th red tile).
I like it so far (the only thing I am not a fan of is the specific image used as a backdrop in the long list, too busy/text hard to read IMO).
Random 3am thought: "I already know hot to use Godot, I want to work on the engine/documentation" is a description I think maybe could be improved:
- I'd prefer something along the lines of "I want to contribute" over "I want to work on the engine/docs"
- It IMO implies a bit too high of a skill needed to contribute, both by saying "I already know" and by the placement as the last button, it kinda implies a visual hierarchy: Learn dev > Learn Godot > Learn advanced Godot > THEN you can contribute
Open to any input, but maybe even something simple like making the text just "I want to contribute to Godot"
Open to any input, but maybe even something simple like making the text just "I want to contribute to Godot"
Done (along with some design tweaks):
Can we split out just the changes to the homepage into another PR? I'm personally in favor of that change but unsure about the changes to the tutorials (now "Manual") index page, and it also seems closer to being done.
Can we split out just the changes to the homepage into another PR? I'm personally in favor of that change but unsure about the changes to the tutorials (now "Manual") index page, and it also seems closer to being done.
Done:
- https://github.com/godotengine/godot-docs/pull/10810
