[Xfce-i18n] Need for more English documentators?
Jasper Huijsmans
jasper at xfce.org
Thu Nov 4 19:58:36 CET 2004
Hi Andrew,
Andrew Conkling wrote:
> I am interested in contributing to Xfce, but since I don't know any
> code, I'd like to help with the documentation. I do know some German,
> but it's definitely not my first language, and I don't really know any
> computer vocabulary. My question is whether there is any work on the
> English documentation for me to do; I'm willing to refine, to edit, to
> write, or just to do whatever needs to be done.
>
> Sorry if this is documented elsewhere; I couldn't find it.
>
lol, guess you can start with documenting that then ;^)
Seriously though, help with documentation would be very much appreciated.
This is what we have now:
- User guide (installed with xfce-utils). Explains concepts and basic
operations for the Xfce desktop environment. As a non-programmer you
are the ideal person to read this over and see if it makes any sense,
and if there are important things missing.
- Manuals. Each component should install a manual explaining its
operation and configuration in more detail. Not all Xfce components
have a manual at the moment, so that is definitely what needs most
work.
Corrections to spelling and grammar are of course appreciated, since
most of us are non-native speakers.
The documentation is written in docbook xml, which is not too
complicated once you've seen the examples that are already present. I
can also easily convert plain text documentation to docbook without too
much effort.
Modules without manual: xfcalendar, xfce4-appfinder, xfce4-iconbox,
xfce4-mixer, xfce4-systray, xfce4-toys, xfce4-trigger-launcher, xfprint.
You have my permission to harrass any one of the developers to obtain
the information you need about their program, either publicly (ML) or in
private mail :-)
Talk to us here or on IRC (might be a problem with the time difference).
Thanks a lot for offering to help out, documentation is an important
part of a software project, and always hard to keep up-to-date.
Jasper
More information about the Xfce-i18n
mailing list