Frank Peters wrote:
Hi again,
You don't need a masters in English for writing documentation. Most
of the folks I met in Lyon have a sufficient knowledge of the
language to at least write some raw material that can be brought
into shape by native language review. Your stylistic and didactical
skills are probably more crititical.
Yes, I would tend to agree, but I have found that people in general
often feel intimidated to contribute for two main reasons :
- lack of self-confidence
- having to deal with rules and regulations before even starting
Whilst it is a "necessary evil" to have at least some formalism, this is
one of the major hurdles for many, who feel that it is already an
immense effort for them to come up with something that others might find
useful (linked to the self-confidence issue, of course). If they have to
overcome these hurdles before they even start, all but the most
confident or hardy tend to say "someone else will undoubtedly provide
for that, and I shall make do with my own personal help notes". This is
not particular to any given language, but I know that Tony Galmiche,
Sophie and Laurent Godard all regularly go to lengths to explain how to
submit documentation, and I believe (though Sophie may correct me if I'm
wrong) that in the French project, we even have some form of online
documentation explaining that (but I can't pinpoint it right now). By
hurdles, I mean of course, reading and understanding the JCA, or the PDL
or the CC, using a particular style or template format.
Obviously, one can always invite people to just write stuff and then
have it put into form afterwards, but in that case, the burden then gets
shifted onto others who already do a lot for the community, and may not
necessarily have the time or the inclination to want to do so on a
permanent basis.
On OOoCon I briefly discussed this dilemma with some folks
from Germany when we were thinking about the next conference
location. The fact that there is no English native language community
(or particularly a US/North America community) keeps all projects
in English more separate resulting in less momentum (bold
thesis that is?).
I would tend to agree, and the fact that there is no specific user
"community" in the sense that we understand it for the N-L groups has
always surprised me somewhat, but it is, I suppose, inevitable.
It would be interesting to know, when this feedback was given. We are
aware of this issue and were and still are working very hard to move
OLH to concise how to instructions and task based help topics.
Well, the feedback I had from my users was highly critical when we first
switched to OOo 1.1.x, and understandably so. Things have been much
improved IMHO with version 2.x, but only last week, one of my members of
staff said they typed in a word (I don't remember which one now) in the
search index and nothing came out of it. When I showed them where to
find the things they were looking for, they turned to me and said, "how
many people do you know like me who would've typed in the keywords you
just entered ?" All of this being with respect to the French version of
course. To be honest, I had to concede defeat on this point. I was
thinking of a similar example with my 13 year old daughter looking to
change the colour of the font in a text she had just typed. I told her
glibly : "Look in the help" So she did, but didn't find immediately what
she was looking for. Obviously, teenagers (or at least my kids !!!)
don't like spending a lot of effort looking for something. We actually
had to spend about 2 minutes trying to find the bit she was interested
in, and that was with me helping her. When we did find the page in
question, it did not appear at the top, but rather we had to scroll down
under the preceding paragraphs (relating to the character properties
dialog box) to find the relevant passage. This is just one example (well
2, if you include my employee's problems ;-) ).
We need to find the right balance (which is always hard to find :-)
I agree, and it will never be easy.
and one way is to get feedback from the users that don't feel
comfortable with the OLH as it is. Unfortunately, this is rarely
the case. This is one thing I wanted to promote at OOoCon. The easiest
way in contributing to OLH is to yell out what you don't like
(and occasionally tell us what you do like, too, so we don't get
overly frustrated :-)
Yes, the positive feedback rarely gets mentioned :-) Maybe one way
around this would be to divide the help up into basic and advanced
tasks. Of course, we would still be faced with the problem of deciding
what goes where :-(, but we could in that case maybe organise a poll
amongst users on the various lists to try and determine that.
Do the IZists know about that?
Hmm, don't know, but I guess most of the leads know. Personally, I hate
IZ for documentation, I find it really does clutter up quickly, but then
others may have a different opinion.
I guess docs doesn't need to use all processes that development
engineering uses. We have different requirements so that's probably
fine. BTW: Where can I read about the Docs&Files system?
Off-hand, I wouldn't know, sorry :-(
Now this is probably something for the writers at Sun here in Hamburg,
we are close to most of the developers, so it should be easier for us
to establish some sort of information flow.
Laurent has mentioned the Extensions project, which is taking off, and
the dba project has produced its own useful documentation to a certain
extent, but I don't know about the others.
I'm enjoying this too. :-)
Alex
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]