phase 2 - episode tag - #108

docs/1.0.md

@@ -225,8 +225,40 @@ The node value is an integer, and represents the season "number".  It is require
 Please do not exceed `128 characters` for the name attribute.
 
 #### Examples
+`<podcast:season>5</podcast:season>`
+
 `<podcast:season name="Race for the Whitehouse 2020">3</podcast:season>`
 
 `<podcast:season name="Egyptology: The 19th Century">1</podcast:season>`
 
-`<podcast:season name="The Yearling - Chapter 3">3</podcast:season>`
+`<podcast:season name="The Yearling - Chapter 3">3</podcast:season>`
+
+<br><br>
+
+
+## Episode
+`<podcast:episode>`
+This element exists largely for compatibility with the `season` tag.  But, it also allows for a similar idea to what "name" functions as in that element.
+
+#### Parent
+`<item>`
+
+#### Count
+Single
+
+#### Node Value
+The node value is a decimal number.  It is required.
+
+#### Attributes
+ - **display:** (optional) - If this attribute is present, podcast apps and aggregators are encouraged to show it's value instead of the purely numerical node value.  This attribute is a string.
+
+The episode numbers are decimal, so numbering such as `100.5` is acceptable if there was a special mini-episode published between two other episodes.  In that scenario, the number would help with proper chronological sorting, while the `display` attribute could specify an alternate special "number" (like `display="100a - Special"`) to display for the episode in a podcast player app UI.  While these options are perfectly legal with this element, podcasts are encouraged to keep this element to it's simplest form of just a single, whole number in the node value and no attributes.
+
+Please do not exceed `64 characters` for the display attribute.
+
+#### Examples
+`<podcast:episode>3</podcast:episode>`
+
+`<podcast:episode>315.5</podcast:episode>`
+
+`<podcast:episode display="Ch.3">204</podcast:episode>`