Comment 2 for bug 175482

Folks, I've just subscribed a couple of LP developers who have worked on the feeds infrastructure. This bug was originally filed as an issue with the announcements feeds, about where the various URL's in the feed should be pointing. But it seems to me that the real problem is that there is no *in code* documentation as to the best practices to follow, for Feed and FeedEntry subclasses, for:

 * the id's
 * the url's (link_alternate etc)

At the moment, this is assigned to me because of the way it affects announcement feeds but I would also like to draw the attention of the feed subsystem architects to the problem and ask them to fix the interfaces and the docstrings. Also, I would like to reiterate that we should have a super-commented implementation, and I would be delighted to make that the announcements.py codebase.