From 6651c85b7c30c1ec088f6dbf5ac04b50b04e51ec Mon Sep 17 00:00:00 2001
From: Artin <lengthmin@gmail.com>
Date: Tue, 28 Aug 2018 18:21:35 +0800
Subject: [PATCH] docs: update joinus (#559)

* update: docs/joinus

* fix english docs

* fix english docs

* update english docs
---
 docs/en/joinus/README.md | 39 +++++++++++++++++++++++++++++++++++++++
 docs/joinus/README.md    | 13 +++++++------
 2 files changed, 46 insertions(+), 6 deletions(-)

diff --git a/docs/en/joinus/README.md b/docs/en/joinus/README.md
index aa722c0de6..aa8209277e 100644
--- a/docs/en/joinus/README.md
+++ b/docs/en/joinus/README.md
@@ -66,6 +66,45 @@ ctx.state.data = {
 };
 ```
 
+<details><summary>If you want to make a podcast RSS</summary><br>
+
+Reference article:
+
+-   [Create a podcast - Apple](https://help.apple.com/itc/podcasts_connect/?lang=en#/itca5b22233a)
+-   [Podcast best practices - Apple](https://help.apple.com/itc/podcasts_connect/?lang=en#/itc2b3780e76)
+-   Itunes podcast XML generator ：https://codepen.io/jon-walstedt/pen/jsIup
+-   Feed Validation Service ：https://podba.se/validate/?url=https://rsshub.app/ximalaya/album/299146/
+
+these datas can make your podcast subscribeable：
+
+```js
+ctx.state.data = {
+    title: '', // The feed title
+    link: '', // The feed link
+    itunes_author: '', // The channel's author, you must fill this data.
+    itunes_category： '',// Channel category
+    image: '', // Channel's image
+    description: '', // The feed description
+    item: [
+        // An item of the feed
+        {
+            title: '', // The item title
+            description: '', // The item content
+            pubDate: '', // The item publishing datetime
+            guid: '', // The item unique identifier, optional, default to the item link below.
+            link: '', // The item link
+            itunes_item_image: '', // The item image
+            enclosure_url: '', // The item's audio link
+            enclosure_length: '', // The audio length, the unit is seconds.
+            enclosure_type: '', // 'audio/mpeg' or 'audio/m4a' or others
+            itunes_duration: '', // Covert the 'enclosure_length' to hh:mm:ss (1:33:52)
+        },
+    ],
+};
+```
+
+</details>
+
 ## Join the discussion
 
 1.  [Telegram Group](https://t.me/rsshub)
diff --git a/docs/joinus/README.md b/docs/joinus/README.md
index c7f6b01626..6743a2d52f 100644
--- a/docs/joinus/README.md
+++ b/docs/joinus/README.md
@@ -66,23 +66,24 @@ ctx.state.data = {
 };
 ```
 
-<details><summary>如果你想制作播客馈送型RSS，点这儿</summary><br>
+<details><summary>如果你想制作播客订阅型RSS，点这儿</summary><br>
 
-播客馈送是指向 XML 格式 RSS（丰富站点摘要）的网址（URL）。
-
-这些多的字段能使你的 RSS 被泛用型播客软件订阅：
+参考文章:
 
 -   [Podcasts Connect 帮助 创建播客 - Apple](https://help.apple.com/itc/podcasts_connect/#/itca5b22233a)
 -   [Podcasts Connect 帮助 播客最佳做法 - Apple](https://help.apple.com/itc/podcasts_connect/#/itc2b3780e76)
 -   RSS 格式参考：https://codepen.io/jon-walstedt/pen/jsIup
 -   播客验证：https://podba.se/validate/?url=https://rsshub.app/ximalaya/album/299146/
 
+这些字段能使你的 RSS 被泛用型播客软件订阅：
+
 ```js
 ctx.state.data = {
     title: '', // 项目的标题
     link: '', // 指向项目的链接
-    itunes_author: '', // 主播名字，并且开启此项就认为该RSS是播客，会自动添加头部的xmlns
+    itunes_author: '', // 主播名字，必须填充本字段才会被视为播客
     itunes_category： '',// 播客分类
+    image: '', // 专辑图片，作为播客源时必填
     description: '', // 描述项目
     item: [
         // 其中一篇文章或一项内容
@@ -95,7 +96,7 @@ ctx.state.data = {
             itunes_item_image: '', // 图像
             enclosure_url: '', // 音频链接
             enclosure_length: '', // 时间戳（播放长度），一般是秒数
-            enclosure_type: '', // [.mp3就填'audio/mpeg'] [.m4a就填'audio/m4a']
+            enclosure_type: '', // [.mp3就填'audio/mpeg'] [.m4a就填'audio/m4a'], 或其他类型.
             itunes_duration: '', // 由enclosure_length转换为 时:分:秒
         },
     ],