diff --git a/README.md b/README.md
index bf0e000..d12049c 100644
--- a/README.md
+++ b/README.md
@@ -256,39 +256,6 @@ Example:
 
 ----
 
-
-### **\<podcast:images>** - <small>[Discuss](https://github.com/Podcastindex-org/podcast-namespace/issues/43)</small>
-
-<br>
-
-<b>
-
-```xml
-<podcast:images
-  srcset="[image urls with sizing attached(string array)]"
-/>
-```
-
-</b>
-
-Channel or Item
-
-(optional | single)
-
-This tag, when present, allows for specifying many different image sizes in a compact way at either the episode or channel level.  The syntax is borrowed from
-the HTML5 [srcset](https://html.spec.whatwg.org/multipage/images.html#srcset-attributes) syntax.  It allows for describing multiple image sources with width and
-pixel hints directly in the attribute.
-
-Example of a single gateway:
-```xml
-<podcast:images
-    srcset="https://example.com/images/ep1/pci_avatar-massive.jpg 1500w,
-            https://example.com/images/ep1/pci_avatar-middle.jpg 600w,
-            https://example.com/images/ep1/pci_avatar-small.jpg 300w,
-            https://example.com/images/ep1/pci_avatar-tiny.jpg 150w"
-/>
-```
-
 <br>
 
 ## Other Proposals
diff --git a/docs/1.0.md b/docs/1.0.md
index 04a91f3..4d13aa9 100644
--- a/docs/1.0.md
+++ b/docs/1.0.md
@@ -710,7 +710,6 @@ The node value is a string denoting one of the following possible values:
 - `newsletter` - Describes a feed of curated written articles.  Newsletter articles now sometimes have an spoken version audio enclosure attached.
 - `blog` - Describes a feed of informally written articles.  Similar to `newsletter` but more informal as in a traditional blog platform style.
 
-
 ### Examples
 Example use for a "podcast":
 ```xml
@@ -720,4 +719,34 @@ Example use for a "podcast":
 Example use for "music":
 ```xml
 <podcast:medium>music</podcast:medium>
+```
+
+
+
+<br><br><br><br><!-- Tag block -->
+## Images
+`<podcast:images>`<br><br>
+This tag, when present, allows for specifying many different image sizes in a compact way at either the episode or channel level.  The syntax is borrowed from
+the HTML5 [srcset](https://html.spec.whatwg.org/multipage/images.html#srcset-attributes) syntax.  It allows for describing multiple image sources with width and
+pixel hints directly in the attribute.
+
+### Parent
+&nbsp; `<channel>` or `<item>`
+
+### Count
+&nbsp; Single
+
+### Attributes
+ - **srcset** (required) A string that denotes each image url followed by a space and the pixel width, with each one separated by a comma.  See the example
+                         for a clear view of the syntax.
+
+### Examples
+Example of specifying four different image sizes:
+```xml
+<podcast:images
+    srcset="https://example.com/images/ep1/pci_avatar-massive.jpg 1500w,
+            https://example.com/images/ep1/pci_avatar-middle.jpg 600w,
+            https://example.com/images/ep1/pci_avatar-small.jpg 300w,
+            https://example.com/images/ep1/pci_avatar-tiny.jpg 150w"
+/>
 ```
\ No newline at end of file