RSS/Atom feed Twitter
Site is read-only, email is disabled

improving the tutorials - let's rock!

This discussion is connected to the gimp-developer-list.gnome.org mailing list which is provided by the GIMP developers and not related to gimpusers.com.

This is a read-only list on gimpusers.com so this discussion thread is read-only, too.

3 of 3 messages available
Toggle history

Please log in to manage your subscriptions.

improving the tutorials - let's rock! Liam R E Quin 22 Sep 03:30
  improving the tutorials - let's rock! gg@catking.net 22 Sep 11:01
  improving the tutorials - let's rock! Michael Schumacher 22 Sep 12:14
Liam R E Quin
2008-09-22 03:30:03 UTC (over 16 years ago)

improving the tutorials - let's rock!

[is there a better list for this? which?]

There's a lot of bad tutorials out there. Some of them are on the gimp.org site, some are on gumpusers.com, etc...

and I said in Poland we needed some hot tutorial love...

Some properties of a good tutorial, I claim, are (1) it tells you at the start
1a. what you will learn
1b. what you must already know in order to use the tutorial 1c. roughly how long it will take you

(2) at each step it shows 2a. a screenshot of the image
2b. any necessary dialogue boxes with settings you must enter 2c. the layers dialogue, or anything else that will help the user know they did the earlier steps correctly 2d. guidance for what to do if you went wrong.

(3) everything you must do is explicitly mentioned, including "select none", "create new layer", "select a layer again after saving the selection to a channel", "choose the brush tool".

(4) any dialogues, screenshots, messages are given in the same language as the tutorial (so on translation, new screenshots may be needed), and language of the tutorial has been checked for obvious errors...

(5) should be under the GNU Free Documentation License.

I don't want to step on anyone's toes here... but maybe we can go through the tutorials on the gimp site, and make new ones, fix bugs and/or improve existing ones?

I notice also, e.g. "GIMPLITE QUICKIES [1]" says, at the top, Text and images Copyright (C) 2004 Carol Spears and may not be used without permission of the author.

I wonder if Carol would be amenable to re-releasing these tutorials under a GNU-compatible license so we can edit them? Or give permission for them to be edited -- since it's too much work for one person to do, and in any case they'd certainly benefit from a second person's eyes...

I'm prepared (GULP) to work on keeping a list of tutorials and their status if some other people can help out e.g. by testing the tutorials (I can do some of that too, and I don't mind working on the English of some of them, too; I can't translate them myself, though).

How about a "Made for GIMP 2.6" icon to go on tutorials that have been checked? (or "Made for 2.8")

I hope one result would be that it would be easier to check the tutorials again next time round...

Liam [Ankh]

gg@catking.net
2008-09-22 11:01:04 UTC (over 16 years ago)

improving the tutorials - let's rock!

On Mon, 22 Sep 2008 03:30:03 +0200, Liam R E Quin wrote:

How about a "Made for GIMP 2.6" icon to go on tutorials that have been checked? (or "Made for 2.8") I hope one result would be that it would be easier to check the tutorials again next time round...
Liam [Ankh]

--

I think some indication of which version of gimp any particular guide is written for is nearly essential at this stage in view of the major rearrangment and internal changes.

Older doc should probably have something added in a conspicuous place indicating either what version it related to (if that can be determined precisely) or a warning that it may be out of date and some features may have changed/moved/disappeared.

Good idea, Liam.

/gg

Michael Schumacher
2008-09-22 12:14:52 UTC (over 16 years ago)

improving the tutorials - let's rock!

Von: Liam R E Quin

There's a lot of bad tutorials out there. Some of them are on the gimp.org site, some are on gumpusers.com, etc...

(2) at each step it shows
2a. a screenshot of the image
2b. any necessary dialogue boxes with settings you must enter 2c. the layers dialogue, or anything else that will help the user know they did the earlier steps correctly 2d. guidance for what to do if you went wrong.

Each step should also have a short summary at the beginning - this way we do not force advanced users to go through all the sub-steps if the do exactly know what to do.

(3) everything you must do is explicitly mentioned, including "select none", "create new layer", "select a layer again after saving the selection to a channel", "choose the brush tool".

Links to the user manual should be included, too.

(5) should be under the GNU Free Documentation License.

Is the GFDL really a suitable license for tutorials? I think that we should at löeast disallow invariant sections.

Regards, Michael