W3C home > Mailing lists > Public > public-egov-ig@w3.org > March 2009

Re: Group Note FPWD is done

From: Jose M. Alonso <josema@w3.org>
Date: Mon, 30 Mar 2009 18:47:52 +0200
Cc: eGov IG <public-egov-ig@w3.org>
Message-Id: <8C8D10D5-2902-4108-B906-E27BE891EEB4@w3.org>
To: Trond Arne Undheim <trond-arne.undheim@oracle.com>
> ...
> 	 I think we have some work to do regarding abbreviations. API, PSI  
> etc. needs to be esplained the first time and the abbreviation put  
> in parenthesis. Sometimes that is not enough either, and the full  
> term is better used throughout to avoid confusion.

Opening ISSUE-11

Abbreviations are all expanded in the HTML code. Sometimes they are  
expanded the first time, probably not all. This could be done for all.

I don't think expanding them every time they appear on text is useful,  
I think it'd be too verbose.

Explaining what it is the first time may be helpful, but I think we  
should not go in much detail on what e.g. XML is in this document.  
Maybe a sentence or two would be OK, then pointer to more info.  
Pointers are already there though.

-- Jose
Received on Monday, 30 March 2009 16:48:45 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:43:08 UTC