Re: [Gimp-developer] gimp-help2

2003-07-23 Thread Daniel Egger
Am Die, 2003-07-22 um 18.34 schrieb David Neary:

 Where is the index? And when you say outline do you mean root
 document with lots of dead links?

Nope, I mean like a rough idea of the table of contents:
   
   1. Introduction
1. Welcome to The GIMP
  1.1. Known platforms
  1.2. The GIMP-Help system
   2. Legalese
1. The GIMP License
   3. Toolbox
1. The Toolbox
2. The Toolbox Menu
3. Rectangle Selection Tool
4. Ellipse Selection Tool
5. Free Selection Tool
6. Fuzzy Selection Tool
7. Select By Color Tool
8. Scissors Tool
9. Patience! For the Jedi it is time to eat as well.
10. Color Picker Tool
11. Histogram
12. Magnify Tool
13. Measure Tool
14. Move Tool
15. Crop Tool
16. Rotate Tool
   4. Filters
1. Filter introduction
2. Blur
  2.1. Overview
  2.2. Options
  2.3. See also...
   Glossary


Don't know how 3.9. slipped in but apart from that it's what we have
right now. We need more introduction, more tool descriptions (also from
those not in the toolbox), plugin descriptions, meta information (like
keyboard shortcuts), examples, screenshots etc...

-- 
Servus,
   Daniel


signature.asc
Description: Dies ist ein digital signierter Nachrichtenteil


Re: [Gimp-developer] gimp-help2

2003-07-23 Thread Carol Spears
Daniel Egger wrote:

Am Die, 2003-07-22 um 18.34 schrieb David Neary:

 

Where is the index? And when you say outline do you mean root
document with lots of dead links?
   

Nope, I mean like a rough idea of the table of contents:
  
  1. Introduction
   1. Welcome to The GIMP
 1.1. Known platforms
 1.2. The GIMP-Help system
  2. Legalese
   1. The GIMP License
  3. Toolbox
   1. The Toolbox
   2. The Toolbox Menu
   3. Rectangle Selection Tool
   4. Ellipse Selection Tool
   5. Free Selection Tool
   6. Fuzzy Selection Tool
   7. Select By Color Tool
   8. Scissors Tool
   9. Patience! For the Jedi it is time to eat as well.
   10. Color Picker Tool
   11. Histogram
   12. Magnify Tool
   13. Measure Tool
   14. Move Tool
   15. Crop Tool
   16. Rotate Tool
  4. Filters
   1. Filter introduction
   2. Blur
 2.1. Overview
 2.2. Options
 2.3. See also...
  Glossary

Don't know how 3.9. slipped in but apart from that it's what we have
right now. We need more introduction, more tool descriptions (also from
those not in the toolbox), plugin descriptions, meta information (like
keyboard shortcuts), examples, screenshots etc...
 

i am stuck on 3.9.

i am going to work up some ideas starting there. maybe even
at neditcon1.
this is a nice list, btw. 
wanna see my 404 dumpster?
http://www.det-tour.org/~carol/gallery/summer/IMG_0223.html

i am very much enjoying making this new gimp make my webpages
right now.
thanks

carol



___
Gimp-developer mailing list
[EMAIL PROTECTED]
http://lists.xcf.berkeley.edu/mailman/listinfo/gimp-developer


Re: [Gimp-developer] gimp-help2

2003-07-22 Thread David Neary
Daniel Egger wrote:
 Am Mon, 2003-07-21 um 23.21 schrieb Jakub Steiner:
  I think this would be pretty elegant and would appeal to me personaly to
  write some particular doc. Write documentation is a horrid picture to
  me. An insanely large task. Write a particular section actually sounds
  fun.
 
 However, I offer you the chance to write a particular section for the
 docs right away... Wanna pick a topic? :)

Would it take you long to put together a list of topics that docs
are needed for? We could cross-post to the gimp-users list, and
maybe send a copy to the GUG and see if anyone there is
interested in helping out...

Just an idea.

Cheers,
Dave.

-- 
   David Neary,
   Lyon, France
  E-Mail: [EMAIL PROTECTED]


pgp0.pgp
Description: PGP signature


Re: [Gimp-developer] gimp-help2

2003-07-22 Thread Jakub Steiner
On Mon, 2003-07-21 at 23:48, Daniel Egger wrote:
 
 We have had this notice in GIMP for quite a while which means that you
 either never even used the helpbrowser or didn't care. :/
 
 However, I offer you the chance to write a particular section for the
 docs right away... Wanna pick a topic? :)

The main motivator I was talking about is bringing up a help browser for
a certain tool, seeing a 'please help' msg.

-- 
Jakub Steiner [EMAIL PROTECTED]

___
Gimp-developer mailing list
[EMAIL PROTECTED]
http://lists.xcf.berkeley.edu/mailman/listinfo/gimp-developer


Re: [Gimp-developer] gimp-help2

2003-07-22 Thread David Neary
Daniel Egger wrote:
 On Tue, Jul 22, 2003 at 09:46:17AM +0200, David Neary wrote:
  Would it take you long to put together a list of topics that docs
  are needed for? We could cross-post to the gimp-users list, and
  maybe send a copy to the GUG and see if anyone there is
  interested in helping out...
 
 Well, there is an outline (i.e. the index) which might give a few hints. 
 A fully fledged would take some time and cooperation though.

Where is the index? And when you say outline do you mean root
document with lots of dead links?

Cheers,
Dave.

-- 
   David Neary,
   Lyon, France
  E-Mail: [EMAIL PROTECTED]
___
Gimp-developer mailing list
[EMAIL PROTECTED]
http://lists.xcf.berkeley.edu/mailman/listinfo/gimp-developer


[Gimp-developer] gimp-help2

2003-07-21 Thread Sven Neumann
Hi Daniel,

Daniel Egger [EMAIL PROTECTED] writes:

 I'd rather we simply render the XML directly because the mapping is
 tricky at two points:

You want us to include an XML renderer in the help-browser? That
doesn't sound like a simple solution.

 - The XML-transformation needs to be taught about creating files
 with a fixed name. This bit us before with SGML and is even more
 tricky with the DocBook/XML stylesheets.

What is tricky about 'xsltproc $xmlfile  $htmlfile'? OK, I have to
admit I don't much experience with the DocBook XML issues you
encountered when working on gimp-help but since I played with this
stuff for developer.gimp.org I cannot follow this argument. Perhaps
I need to take a closer look at gimp-help2 first...

 - The docs need to be kept in sync with the GIMP Source which is a
 tedious work.

How would your solution avoid this problem?

 I don't think we have enough manpower to get the help done in
 time. I've a business to run, have no idea where syngin is and it
 seems we still have no content writers. My guesstimate for efforts
 we'd need to put into it would be 400h to get something which is
 showable.

But I would perhaps make sense to setup the framework and encourage
people to contribute help for gimp-2.0. We could setup some text that
is displayed for all missing pages and that explicitely encourages
people to write help on this topic.


Sven
___
Gimp-developer mailing list
[EMAIL PROTECTED]
http://lists.xcf.berkeley.edu/mailman/listinfo/gimp-developer


Re: [Gimp-developer] gimp-help2

2003-07-21 Thread Jakub Steiner
On Mon, 2003-07-21 at 17:23, Sven Neumann wrote:

 
 But I would perhaps make sense to setup the framework and encourage
 people to contribute help for gimp-2.0. We could setup some text that
 is displayed for all missing pages and that explicitely encourages
 people to write help on this topic.

I think this would be pretty elegant and would appeal to me personaly to
write some particular doc. Write documentation is a horrid picture to
me. An insanely large task. Write a particular section actually sounds
fun.

-- 
Jakub Steiner [EMAIL PROTECTED]

___
Gimp-developer mailing list
[EMAIL PROTECTED]
http://lists.xcf.berkeley.edu/mailman/listinfo/gimp-developer


Re: [Gimp-developer] gimp-help2

2003-07-21 Thread Daniel Egger
Am Mon, 2003-07-21 um 23.21 schrieb Jakub Steiner:

 I think this would be pretty elegant and would appeal to me personaly to
 write some particular doc. Write documentation is a horrid picture to
 me. An insanely large task. Write a particular section actually sounds
 fun.

We have had this notice in GIMP for quite a while which means that you
either never even used the helpbrowser or didn't care. :/

However, I offer you the chance to write a particular section for the
docs right away... Wanna pick a topic? :)

-- 
Servus,
   Daniel


signature.asc
Description: Dies ist ein digital signierter Nachrichtenteil