COGA: Proposal on the short name for citations.

We had a really good call yesterday on citations . If you were not on the
call but are interested in the discussion please see the minutes
<https://www.w3.org/2025/09/29-coga-minutes.html>


I would like to make a  proposal  on the short name based on the
discussion and see if we can finish off this debate (and start adding the
citations to the documents!)


   1. *If it is an academic paper *use the database key followed by the
   first author and the number the author occurred in the database. The result
   would look like: RM-Smith1 (RM is the reference for mental health
   literary review database, smith is the primary author, and 1 is this is the
   first occurrence).
   2. *For laws and standards *use the accepted short name in the field and
   record it as a key in our spreadsheet/ database. For example, WCAG1.0 or
   Section508. (This was agreed on on the call.)
   3. *If it is  another resource (blog, fact sheet etc)  *use the database
   key followed by the initials of the site/organisation name (main site, not
   subsites) and the number this occurred in our spreadsheet. The result would
   look like: RC-WHO1 (RC is the Reference for Coga sources and literary
   review spreadsheet , WHO are the initials of the site, such as the world
   health organization, and 1 is this is the first occurrence in our
   spreadsheet. )



If you agree with this or disagree, please respond. Lets try and close this
over the next few days.

Other resolutions from the call were:

   1.  Citations go at the end of the paragraph unless they go well with
   the natural way to read the paragraph (such as standard shortname). If it
   is part of the reading of the true text the citation can be  inline .If it
   is citation only it should be at the  end of the paragraph )
   2. We would style citation references at the end of the paragraph so
   that they are readable but easy to differentiate from the main text. We
   will use a css class so we can experiment!

All the best

Lisa Seeman-Horwitz

LinkedIn <http://il.linkedin.com/in/lisaseeman/>, Twitter
<https://twitter.com/SeemanLisa>

Received on Tuesday, 30 September 2025 16:24:09 UTC