From 87da50040b2d11af06392c46de0660752afce800 Mon Sep 17 00:00:00 2001 From: Cj Malone Date: Thu, 26 Jan 2017 10:40:26 +0000 Subject: [PATCH] Inital Override namespace --- Overview.txt | 0 Schemas/Override.txt | 96 ++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 96 insertions(+) create mode 100644 Overview.txt create mode 100644 Schemas/Override.txt diff --git a/Overview.txt b/Overview.txt new file mode 100644 index 0000000..e69de29 diff --git a/Schemas/Override.txt b/Schemas/Override.txt new file mode 100644 index 0000000..e9dcd59 --- /dev/null +++ b/Schemas/Override.txt @@ -0,0 +1,96 @@ +Namespace name: https://schema.syndicated.media/override/1.0 +Recommended prefix: overrides +Status: Pre release + +Introduction + +The Overrides namespaace is an extension to RSS 2.0 and Atom 1.0 feeds +that allows a a newer item/entry to replace or override an older one. + +Replacing an item can be useful in a couple of situations, you could +release a corrupt enclosure and want to force clients to re download the +file. Or you could also want to rerun a previous episode. + +overrides:replaces + +The replaces element is a optional child of item or entry. It's value is +either a previous guid (in RSS) or id (in Atom), the item referenced has +likely been removed from the feed but may be cached by the client. + +The client should then purge the old item in favour of this one. + +An item or entry must not contain more than one replaces element. + +overrides:rerun + +The rerun element is a optional child of item or entry. It value is +either a previous guid (in RSS) or id (in Atom), the item referenced may +or may not still be in the feed and may or may not be cached by the +client. + +This allows the client to treat reruns differently to ordinary items, and +also link any status information between the two items. + +An item or entry must not contain more than one rerun element. In the +case of a item being rerun multiple times the value should be the guid +of the oldest occurrence. + +The RSS or Atom source element should also be used in reruns. + +Example + +In this example there was in issue with Episode 3 release, the original +item has been removed and the new one replaces it. Episode 1 also gets +rerun twice. + + + + + Override example + https://example.org + + An example of the Overrides namespace in a RSS 2.0 feed. + + Episode 1 rerun + https://example.org/1 + This is also a rerun of Item 1 + tag:example.org,2017-01-26:/7 + tag:example.org,2017-01-26:/1 + Episode 1 + + + Episode 1 rerun + https://example.org/1 + This is a rerun of Item 1 + tag:example.org,2017-01-26:/6 + tag:example.org,2017-01-26:/1 + Episode 1 + + + Episode 4 + https://example.org/4 + This is Item 4 + tag:example.org,2017-01-26:/5 + + + Episode 3 + https://example.org/3 + This is Item 3. Sorry if you in counted an issue with this episode, it's now fixed. + tag:example.org,2017-01-26:/4 + tag:example.org,2017-01-26:/3 + + + Episode 2 + https://example.org/2 + This is Item 2 + tag:example.org,2017-01-26:/2 + + + Episode 1 + https://example.org/1 + This is Item 1 + tag:example.org,2017-01-26:/1 + + + +