API documentation is confusing

So I'm trying to help get commentrss integrated with syndication, but as easy as I thought it would be, the documentation is confusing the hell out of me. Here's how I've tried to learn:

1. Read the README.txt. It tells me "Also, modules may insert their own boxes onto this page using hook_syndication. See Help for details." There is no help section or anything on the hook in the README.txt. WTF.

2. Look for the hook documentation in a file possibly named syndication.api.php. No such file found.

3. Read syndication.module. Realize the 'Help' in the README.txt means the syndicaiton_help pages on the site and not anything in the code. I'm not ready to enable the syndication module yet. Why force me to do that in order to read hook documentation?

4. Finally look at the *bottom* of the module file and find it and I'm still confused as to how this hook has to do with RSS feeds at all. According to the example, syndication is not going to know anything about the paths to the RSS feeds the my module provides.

/**
 * Allows modules to add RSS feeds to the Syndication page
 *
 * Any module can export boxes to the syndication page. You do so
 * by creating a <i>modulename</i>_syndication function which returns
 * an associative array of boxes, much like the block module. Each box
 * in the array requires <i>subject</i> and <i>content</i> fields. Example:
 * function mymodule_syndication() {
 *   $box[0]["subject"] = "Existentialism";
 *   $box[0]["content"] = "So many feeds in this world";
 *
 *   $box[1]["subject"] = "Got any question?";
 *   $box[1]["content"] = "Who, Where, Why, When";
 *  return  $box;
 * }
 */
function hook_syndication() {
  // Creating the first box
  $box[0]["subject"] = "Existentialism";
  $box[0]["content"] = "So many feeds in this world";

  // Lets create a one box more
  $box[1]["subject"] = "Got any question?";
  $box[1]["content"] = "Who, Where, Why, When";
  return  $box;
}

This is frankly, not helpful at all. Can someone please help me figure out how this hook works and can something please be done about the documentation? Please?