>
>
> On Sat, Feb 05, 2011 at 05:30:54PM +0200, Michael Grosberg wrote:
> > Hello all,
> >
> > Following a discussion on the main Gimp mailing list I'd like to offer my
> > help in improving Gimp's Documentation.
> [...]
>
> welcome aboard! Every help is appreciated!
>
> Feel free to ask.
>
> my 10 cent: use Linux as the manual dev platform!
>
>
> Okay, let's begin with the questions: I have many.

First of all, how do things work in this project, in terms of process,
decision-making, etc? My aim is to make the documentation better by changing
things such as "how to be a gimp wizard" and other miscellaneous strange
terms in the documentation, and make it easier for a user to find what they
are looking for (wizardry, I suspect, is not among them).
But obviously not all changes are well received by everyone, so what I most
need to know, is who has the power to accept or reject changes? How do you
review / discuss changes? Is the manual in other languages 100% identical to
the English one and how does that affect my ability to change the English
manual?

I think until I figure that out I'll restrict myself to learning the system,
and cut my teeth on some low-hanging fruit such as finding instances of "The
Gimp" and replacing them with "Gimp".

Now, to technical matters: Working with GIT and the XML.

I'm on Ubuntu 10.10, and have downloaded a copy of the GIT repository as
described in the "help us" page. Now, the thing is, I'm no programmer. I'm
familiar with version control - specifically Microsoft Team Foundation
server (at work), but I've never really worked on code, just art resources.
So I'm kinda lost when it comes to GIT. Is there a recommended front end /
GUI to access it? Or do you do all your checkout and commits in the
terminal? As an artist I'm much more GUI-oriented.

I browsed the repository and I see help pages are written in XML. Do you
hand-code everything, or do you have some easier way to write pages in an
editor? And is there documentation on how to write said XML or do I just
read the existing pages and do my best to emulate that?

That's all for now, if you have anything specific you need done that would
also be good.

Michael
_______________________________________________
Gimp-docs mailing list
Gimp-docs@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs

Reply via email to