Phil has pointed out that the CommentAPI details how pingbacks and trackbacks are mapped to the RSS 'item' element but it does not detail how a comment is mapped. I have been using a mapping on my implementation of the CommentAPI but haven't documented it. Here is the current mapping:
<item> <title>Joe</title> <link>http://bitworking.org</link> <description>The actual text of the comment goes here.</description> </item>
I.e. the 'title' is the comment authors name and the 'description' is the comment content. Note that the 'link' element is either a link or could also contain an e-mail address.
Phil has suggested that the 'title' element should not be used for the authors name but instead used for the title of the comment and instead 'dc:creator' should be used for the comment authors name. What do you think?