After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 730736 - Lack of tutorials
Lack of tutorials
Status: RESOLVED OBSOLETE
Product: glade
Classification: Applications
Component: documentation
3.10.x
Other Linux
: Normal enhancement
: ---
Assigned To: Glade 3 Maintainers
Glade 3 Maintainers
Depends on:
Blocks:
 
 
Reported: 2014-05-25 22:17 UTC by Tobias Schönberg
Modified: 2018-03-26 15:36 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Tobias Schönberg 2014-05-25 22:17:14 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.
Comment 1 Tristan Van Berkom 2014-05-25 22:38:20 UTC
Tobias,

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:

   https://developer.gnome.org/eds/unstable/eds-cursor-example.html

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).
Comment 2 Tobias Schönberg 2014-05-26 08:46:50 UTC
Which software would you use to make the tutorials and can screenshots be included?
Comment 3 GNOME Infrastructure Team 2018-03-26 15:36:55 UTC
-- 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.