From d3ee337021a236ad83aac77e179e01a53006d21c Mon Sep 17 00:00:00 2001 From: Dave Jones Date: Thu, 4 Aug 2022 14:03:34 -0500 Subject: [PATCH] finalize the block tag --- README.md | 53 +------------------------------------------------- docs/1.0.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++- 2 files changed, 56 insertions(+), 53 deletions(-) diff --git a/README.md b/README.md index 1a3df83..7468344 100644 --- a/README.md +++ b/README.md @@ -171,64 +171,13 @@ The following tags have been formally adopted into the namespace. They are full full implementation details. - **\**
+- **\**

The following tags are under review for inclusion in this phase. Changes to them are now frozen. Any modifications will mean the tag needs to be reworked and submitted to Phase 6. -

-### **\** - [Discuss](https://github.com/Podcastindex-org/podcast-namespace/issues/179) - - -```xml - -[yes|no(bool)] - -``` - - - -#### Channel - -#### (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 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 - - **id** (optional) A single entry from the [platform slug list](serviceslugs.txt). - -Examples: -```xml - -yes -``` - -```xml - -no -``` - -```xml - -yes -yes -``` - -```xml - -yes -no -no -```

diff --git a/docs/1.0.md b/docs/1.0.md index 05c5712..fbf87be 100644 --- a/docs/1.0.md +++ b/docs/1.0.md @@ -919,4 +919,58 @@ Example (complex): Example (disabled): ```xml -``` \ No newline at end of file +``` + + + +



+## Block +``

+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 +by the inclusion of the `id` attribute and by including multiple copies of itself in the feed. + +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. + +In plain language, the sequence of discovery an ingesting platform should use is as follows: + + 1. Does `no` exist in this feed? Safe to ingest. + 2. Does `yes` exist in this feed? Do not ingest. + 3. Does `yes` exist in this feed? Do not ingest. + + +### Parent +  `` + +### Count +  Multiple + +### Attributes + - **id** (optional) A single entry from the [service slug list](https://github.com/Podcastindex-org/podcast-namespace/blob/main/serviceslugs.txt). + + +### Examples +```xml + +yes +``` + +```xml + +no +``` + +```xml + +yes +yes +``` + +```xml + +yes +no +no +```