diff --git a/README.md b/README.md index 06fd0bd..e473aa8 100644 --- a/README.md +++ b/README.md @@ -135,92 +135,6 @@ The following tags have been finalized ahead of formal consideration and review
-### **\** - [Discussion](https://github.com/Podcastindex-org/podcast-namespace/issues/84) - -
- - - -```xml - -[Title of Trailer(string)] - -``` - - - -Channel - -(optional | multiple) - -This element is used to define the location of an audio or video file to be used as a trailer for the entire podcast or a specific season. There can be more than one trailer present in the channel of the -feed. If there is more than one present, the most recent one (according to it's `pubdate`) should be chosen as the preview by default within podcast apps. If the `season` attribute is present, it must be a number that matches -the format of the `` tag. So, for a podcast that has 3 published seasons, a new `` tag can be put in the channel to later be matched up with a `4` -tag when it's published within a new ``. - -This element is basically just like an `` with the extra `pubdate` and `season` attributes added. - -- `url` (required) This is a url that points to the audio or video file to be played. -- `pubdate` (required) The date the trailer was published. -- `length` (recommended) The length of the file in bytes. -- `type` (recommended) The mime type of the file. -- `season` (optional) If this attribute is present it specifies that this trailer is for a particular season number. - -Example: -```xml -Coming April 1st, 2021 -``` - -Example with Season Linkage: -```xml -Season 4: Race for the Whitehouse - -(later matches with) - -4 -``` - -
- -### **\** - [Discussion](https://github.com/Podcastindex-org/podcast-namespace/issues/177) - -
- - - -```xml - -[license slug(string)] - -``` - - - -Channel or Item - -(optional | single) - -This element defines the license that is applied to the audio/video content of the episode or the audio/video of the podcast as a whole. The node value -should be a lower-cased reference to a license "identifier" defined in the [SPDX License List](https://spdx.org/licenses/) file or, if it's a custom license, it -can be a free form abbreviation of the name of the license. Custom licenses should always include a url attribute reference. - -- `url` (optional) This is a url that points to the full license details for this license. - -Example: -```xml -cc-by-4.0 -``` - -
- ### **\** - [Discussion](https://github.com/Podcastindex-org/podcast-namespace/issues/174#issue-798007719)
diff --git a/docs/1.0.md b/docs/1.0.md index e3022fb..12dde3f 100644 --- a/docs/1.0.md +++ b/docs/1.0.md @@ -307,3 +307,28 @@ tag when it's published within a new ``. 4 ``` + +

+ + +## License +`` +This element defines a license that is applied to the audio/video content of a single episode, or the audio/video of the podcast as a whole. Custom licenses must always include a url attribute. + +#### Parent +`` or `` + +#### Count +Single + +#### Node Value +The node value must be a lower-cased reference to a license "identifier" defined in the [SPDX License List](https://spdx.org/licenses/) file if the license being used is a well-known, public license. Or, if it is a custom license, it +must be a free form abbreviation of the name of the license as you reference it publicly. + +#### Attributes + - **url:** (optional) This is a url that points to the full, legal language of the license being referenced. This attribute is optional for well-known public licenses. For new, or custom licenses it is required. + +#### Examples +`cc-by-4.0` + +`my-podcast-license-v1` \ No newline at end of file