diff --git a/docs/tags/podroll.md b/docs/tags/podroll.md index 24f3cc7..0f98e25 100644 --- a/docs/tags/podroll.md +++ b/docs/tags/podroll.md @@ -2,7 +2,7 @@ `` -This element allows for a podcaster to include references to one or more podcasts in it's `` as a way of "recommending" other podcasts to their listener. +This element allows for a podcaster to include references to one or more podcasts in its `` as a way of "recommending" other podcasts to their listener. It's normally shown in user interfaces as "creator recommendations", or "shows you might like". ### Parent @@ -16,7 +16,7 @@ Single The node value must be one or more [``](remoteItem.md) elements. -### Example +### Examples ```xml @@ -25,3 +25,33 @@ The node value must be one or more [``](remoteItem.md) eleme ``` + +Above, the simplest way to use a podroll, using the [one mandatory value for the `remoteItem`](remoteItem.md). + +```xml + + + + + +``` + +Above, a recommended podroll entry. It includes the `feedUrl` as well as the `feedGuid`, to help podcast apps discover shows without the GUID if they need to. It also includes a title, which is helpful for humans, and potentially for display in the app. + +If information differs, information discoverable from the GUID always takes precedence. RSS feeds can change; the [GUID](guid.md) does not. + +While the remoteItem includes an optional `itemGuid`, it is not expected that a podroll would normally link to individual episodes. + +(Humans: you can [put a GUID into the search box](https://podcastindex.org/search?q=917393e3-1b1e-5cef-ace4-edaa54e1f810&type=all) on the Podcast Index website).