On Monday 21 August 2006 8:27 am, Chris Cannam wrote:

> Ah, I didn't see that.
>
> I do think your English is perfectly good enough for the handbook, though
> if Michael's happy to do the polishing and integration that's fine with me.

I am in this one instance, but I generally think we do need to move to a WTFM 
policy.  You write the feature, you understand the feature better than 
anybody, so go write or rewrite the manual bits describing it as part of the 
process of introducing the feature.  Something is better than nothing, and if 
our manual is slightly disjointed as a consequence, then we're in good 
company.  It's easier to edit existing material a little than to sit down and 
produce it from scratch, and nobody wants to take the manual job full time, 
including me.

In this particular situation, I guess I've done about the best job I care to 
do translating his list of salient points into the language of the manual, 
and my previous request was a poorly expressed suggestion that he might want 
to go tweak it up to his own satisfaction, if he did not find that I had done 
a good enough job, which he apparently hasn't.

I was going for "adequate" on that.

After spending a little time doing some reading through dictionaries, I see 
the word "adequate" and its natural Spanish translation "adecuado" really 
leave the door open to read more meaning into that term than I intended.  It 
was a poor word choice.

What I meant by "adequate" was more along the lines of "at least better than 
nothing, if not necessarily completely satisfying."

I'd say I've done an adequate job by that measure, and it's about all the 
docbook wrangling I've got in me at this stage, coming to grips with the 
onset of autumn, and the limbo I'm still in caught in this weird space 
between the end of one career and the beginning of another.  I really hate 
writing documentation in a markup language.  That's why I didn't write any of 
my own stuff in a markup language.

-- 
D. Michael 'Silvan' McIntyre  ----   Silvan <[EMAIL PROTECTED]>
Linux fanatic, and certified Geek;  registered Linux user #243621

Author of Rosegarden Companion http://rosegarden.sourceforge.net/tutorial/

-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
Rosegarden-devel mailing list
Rosegarden-devel@lists.sourceforge.net - use the link below to unsubscribe
https://lists.sourceforge.net/lists/listinfo/rosegarden-devel

Reply via email to