GNOME Bugzilla – Bug 730736
Lack of tutorials
Last modified: 2018-03-26 15:36:55 UTC
The lack of tutorials for Glade is a real problem. I could help out with some simple tutorials but don't know which form they should have. I would need help with a matplotlib-widget tutorial myself. Maybe people with different levels and areas of expertise could all pitch in one tutorial.
I think the major problem with the existing tutorials so far is that they have been scattered across the internet and maintainers have little control over them, if they are even aware of the existance of said tutorials.
I think the effort to migrate the GObject tutorial *into* the GObject documentation has improved this.
I also like how glib/gio/tests contains a number of example programs which are included verbatim in the sources.
This is an example of what I started for EDS:
I think it would be nice to have an "Examples" section in the reference manual for any given component, where we can add comments and a walkthrough in the regular sgml docs format, including portions of actual compiling source code along the way.
The advantage of this is that the maintainer is always somewhat aware of the tutorials which exist - and you have the extra satisfaction of knowing that your examples / sample code is regularly compiled with every build (so you always know that your example code at least compiles, bonus points if your example code is also used within your unit test suite).
I'm not sure that this is a problem particular to Glade, or that it merits to be tracked in the bug tracker - I won't close it straight away but at least mark it as an enhancement bug (let's treat it like a feature request).
Which software would you use to make the tutorials and can screenshots be included?
-- GitLab Migration Automatic Message --
This bug has been migrated to GNOME's GitLab instance and has been closed from further activity.
You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.gnome.org/GNOME/glade/issues/159.