[PATCH] Add long comments to shared-mime-info XML file

Dan Winship danw at novell.com
Thu Oct 13 10:02:56 PDT 2005


Steve Kelem wrote:
> I disagree.  Tellling the reader what an acronym means allows the reader 
> to look it up, even if you don't provide a pointer to where to get more 
> info.

Googling for "CSS" gives "about 236,000,000" hits. Googling for 
"Cascading Style Sheets" gives "about 10,100,000" hits. The acronym is 
20 times more commonly-used than the name. (Doing a search on Amazon 
titles, the advantage drops to a mere factor of 4.)

CSS is even a bit of an edge case here; "JPEG" gets 140 times more hits 
than "Joint Photographic Experts Group". "PCI" gets 1400 times more hits 
than "Peripheral Component Interconnect". (Raise your hand if you even 
knew what PCI stood for. Oh, hi there, you in the back. Now go back to 
writing device drivers.)

When the acronym is the standard way of referring to something, we 
should follow standard usage and just use the acronym. In most such 
cases, expanding the acronym won't actually provide the user with any 
useful information. If we want to give users more help at identifying 
mystery files, it would be more useful to provide a description ("Style 
sheet for a web page", "Format for storing photo-quality images very 
compactly") than to just expand the acronyms.

-- Dan



More information about the xdg mailing list