Styling documentation
The documentation for styling in GNOME is quite scattered, and some basic patterns are not covered anywhere. This was one of my major pain point when getting started.
I would like to suggest a "Styling" documentation that covers
- difference between Gtk.Label attributes, pango markup, CSS and when to use what
- very short introduction to CSS (and links to dive deeper)
- platform style classes (link to https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/style-classes.html )
- supported properties (link to https://docs.gtk.org/gtk4/css-properties.html)
- supported selectors (link to https://docs.gtk.org/gtk4/css-overview.html)
- some example for common patterns such as id/class selectors with widgets and GTK builder
- Styles and appearance (link to https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1.2/styles-and-appearance.html)
- Named colors (link to https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1.2/named-colors.html)
- Automatic resources (link to https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.Application.html#automatic-resources)
WDYT?