diff --git a/publishers/publishers.md b/publishers/publishers.md new file mode 100644 index 0000000..f275c81 --- /dev/null +++ b/publishers/publishers.md @@ -0,0 +1,96 @@ +## Publisher medium details + +Below, you will find implementation details about using the `publisher` value in the `` tag to +create "publisher feeds". + +
+ +### Overview + +The idea of a "publisher" is that a single entity (person, organization, record label, etc) might be the responsible +party which produces multiple podcast feeds. In such a case it would be useful to be able to see all of a +publisher's podcasts collected in a single place. For instance, a news organization might produce 12 different +podcast feeds. Or, a music artist might produce 3 albums of music using the `` tag of `music`. In +those cases, having a high level feed that references these other feeds would make it easier for podcast apps to +associate those feeds with a particular publishing entity. + +Likewise, it is helpful if the produced feeds link back to the "publisher feed" so that podcast apps can walk back +up the chain from a podcast feed to it's publisher in order to find other relevant content from that publishing +entity. For instance, a listener may subscribe to a music album by an artist and want to find their other +albums and singles. + +When a publisher feed links to it's "child" feeds, and those "child" feeds link back to their "parent" publisher +feeds, this provides a two-way validation that a feed is indeed a valid part of a publishing entities portfolio of +content. If a feed links to a publisher feed without the publisher feed referencing it, that association should be +discarded. + +
+ +### Publisher Feed Requirements + +A publisher feed must have the following parts: + +1. A `` tag with a value of `publisher`. +2. A valid ``. +3. One or more `` tags that link to podcast feeds. + +#### Example + +The following example shows a publisher feed that links to all of the feeds published by the "AgileSet Media" entity. +This feed also makes use of the `` tag to define a responsible person at the publishing entity. + +```xml + + + AgileSet Media + https://agilesetmedia.com + AgileSet Media is an unincorporated, unregistered, and unpapered entity of AgileSet LLC for producing and publishing stuff by Mike Neumann. It is based in Texas, USA. + + https://agilesetmedia.com/assets/static/AgileSet-logo-square-sm-144.png + AgileSet Media + https://agilesetmedia.com + 144 + 144 + + Mike Neumann + 003af0a0-6a45-55bf-b765-68e3d349551a + publisher + + + + + +``` + +
+ +### Linking to Publisher Feeds + +While not strictly required, adding a reference to the publisher feed from the "child" feeds is a good idea, as it +makes discovery of your other content much easier. Podcast apps can see this linkage and "walk back up the chain" +to your publisher feed and then recommend your other podcast content to a listener. + +#### Example + +The following example snippet shows a podcast feed produced by "AgileSet Media" that links to the publisher feed +example above. + +```xml + + + <![CDATA[It's A Mood]]> + A value4value happenstance music show. + https://itsamood.org + Sovereign Feeds + Mike Neumann + 469b403f-db2d-574c-9db9-96dbb3f6561c + podcast + + + <![CDATA[Runnin']]> + Wed, 03 Apr 2024 02:06:28 +0000 + ... + + + +``` \ No newline at end of file