Documentation Request: Discoverability Coverage
Especially for someone just starting out with GTK, it can be difficult to find the right widget for a given interaction effect. For example, I almost gave up on trying to figure out how to get HdySqueezer to transition between a side-bar on the right until I looked through the example apps and came across HdyLeaflet.
Something that would have helped a lot is to have more screenshot coverage in the documentation -- prose descriptions of the widgets aren't always sufficient to make it clear what the widget's role is. (btw, the visual index is a fantastic feature!) Here's a quick survey of pages without screenshots that could use one:
-
https://developer.puri.sm/projects/libhandy/unstable/HdyCarousel.html -
https://developer.puri.sm/projects/libhandy/unstable/HdyColumn.html -
https://developer.puri.sm/projects/libhandy/unstable/HdyLeaflet.html -
https://developer.puri.sm/projects/libhandy/unstable/HdyPreferencesGroup.html -
https://developer.puri.sm/projects/libhandy/unstable/HdyPreferencesPage.html -
https://developer.puri.sm/projects/libhandy/unstable/HdySqueezer.html