> -----Original Message-----
> From: Philip Olson [mailto:philip@;cornado.com]
> Sent: 08 November 2002 21:32
> To: Ford, Mike [LSS]
> 
> How about instead we use, for example, the <acronym> tag (or
> similar) so:
> 
>   <acronym>CVS</acronym>
> 
> And in acronyms.xml we would list a definition for such terms.
> I don't know if <acronym> is the appropriate tag but the
> idea is what's important here.  I prefer this method.

Yes, this is nice.

> 
> Avenger is translating english to chinese, he knows what CVS 
> means but wasn't sure about the context.  I blame the
> note, which shouldn't have been there.  But of course your
> point is valid.

Apologies if I used an inappropriate platform to launch into one of my
favourite mini-rants ("Use plain English wherever possible..." "Use plain
English wherever possible..." "Use plain English wherever possible..."), but
if it gets results...

> > There's some other terminology used in various places that's rather
> > "techie" and I'd like to see replaced with a more plain-language
> > description -- when (or perhaps that should be IF) I have some spare
> > time, I'd like to identify these and put some proposals to 
> the list.  
> > (And, yes, eventually I'd like to get CVS access and 
> actively help --
> > I'm especially interested in the structured argument lists and
> > CHANGELOG proposals that are currently being discussed.)
> 
> Please list a few other terms, I'm curious.  Sometimes these
> techie terms are important and if people don't understand them
> they shouldn't use the function!  Of course I'm being a little
> conservative on the idea and can only offer my opinions on a
> case-by-case basis :)  I look forward to your CVS access to the
> phpdoc tree and hope spare time finds its way into your life and
> into the php manual.

Well, such a list is one of the things I need some spare time for ;) -- at
the moment, it's just an impression I've formed from fighting my way through
a selection of manual pages.  I'll try to be a bit more rigorous about
noting such usages as and when I come across them!

Cheers!

Mike

---------------------------------------------------------------------
Mike Ford,  Electronic Information Services Adviser,
Learning Support Services, Learning & Information Services,
JG125, James Graham Building, Leeds Metropolitan University,
Beckett Park, LEEDS,  LS6 3QS,  United Kingdom
Email: [EMAIL PROTECTED]
Tel: +44 113 283 2600 extn 4730      Fax:  +44 113 283 3211 

-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Reply via email to