From 0cbecca4949846046431123617a2ee70b65167e8 Mon Sep 17 00:00:00 2001 From: Dave Jones Date: Wed, 3 Aug 2022 22:27:21 -0500 Subject: [PATCH] block tag changes --- README.md | 40 ++++++++++++++++++++++++++-------------- 1 file changed, 26 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 56493a1..90d16a9 100644 --- a/README.md +++ b/README.md @@ -193,30 +193,42 @@ to be reworked and submitted to Phase 6. #### Channel -#### (optional | single) +#### (optional | multiple) -This element allows a podcaster to express which platforms are allowed to publicly display this feed and it's contents. In it's basic form, it is a direct drop-in -replacement for `` and functions identically. The addition of the `exclude` attribute allows for a comma separated list of platforms from the [slug list](serviceslugs.txt) -to be given which operates as an inversion of the intent expressed by the node value. +This element allows a podcaster to express which platforms are allowed to publicly display this feed and it's contents. +In it's basic form, it is a direct drop-in replacement for the `` tag, but allows for greater flexibility +with the inclusion of the `id` attribute and/or multiple copies of itself. + +Platforms should not ingest a feed for public display/use if their slug exists in the `id` of a `yes` block tag, or if +an unbounded `yes` block tag exists (meaning block all public ingestion). Conversely, if a platform finds their slug in +the `id` of a `no` block tag, they are free to ingest that feed for public display/usage. #### Attributes - - **exclude** (optional) A comma separated list of platforms that will be interpreted as a block list or an allow list based on the inversion of the node value (yes or no). + - **id** (optional) A single entry from the [platform slug list](serviceslugs.txt). Examples: ```xml yes - - -no - - -yes - - -no ``` +```xml + +no +``` + +```xml + +yes +yes +``` + +```xml + +yes +no +no +```