diff --git a/.github/PULL_REQUEST_TEMPLATE b/.github/PULL_REQUEST_TEMPLATE
index 030d8674..7a6f43c4 100644
--- a/.github/PULL_REQUEST_TEMPLATE
+++ b/.github/PULL_REQUEST_TEMPLATE
@@ -1,20 +1,42 @@
 <!-- Thanks for contributing to open-source-ios-apps 😊 -->
 
+**Please do not edit the README, instead make changes to `contents.json` **
+
 <!-- When making an addition: -->
-1. [ ] Project URL: 
+
+1. [ ] Project URL:
 2. [ ] One project per pull request
 3. [ ] Insert the project in alphabetical order
-4. [ ] Avoid iOS or open-source in description as it is assumed 
+4. [ ] Avoid iOS or open-source in description as it is assumed
 5. [ ] Use this commit title format if applicable: Add app-name by @github-username
 6. [ ] Use approved format for your entry (use 🔶 for Swift projects)
 
-<!-- Approved Format 
+<!-- Approved Format
 
-- App name: Short description 🔶
-- source url, i.e. https://github.com/username/project
-- https://itunes.apple.com/app/app-name/id-zzz
+At minimum
 
-or
+```js
+  {
+		"title": "MrCode",
+		"category": "github",
+		"description": "GitHub iPhone app that can cache Markdown content",
+		"source": "https://github.com/haolloyin/MrCode" // note, no comma on last line
+  }
+```
+
+Optionally
+
+```js
+  {
+		"title": "MrCode",
+		"category": ["github", "parse"],
+		"description": "GitHub iPhone app that can cache Markdown content",
+		"lang": "zho",
+		"source": "https://github.com/haolloyin/MrCode",
+		"itunes": "https://itunes.apple.com/app/id1234567890",
+		"tags": ["swift"],
+		"stars": 200
+  }
+```
 
-- [App name](source url): Short description 🔶
 -->