updates to templates

Signed-off-by: JohnnieJnr <johnnieoduro@gmail.com>

.github/pull_request_template.md

@@ -1,31 +1,33 @@
-# Pull Request Template
-
 ## Writer's Checklist
 
-- [ ] **Follow Writing Structure**
-  - [ ] I have used more than two H2 subtitles to organize content.
-  - [ ] Include an introduction with at least two paragraphs before the first H2 section.
-  - [ ] Use bold, italic, underline, notes, quotes, TLDRs, and key points as needed.
-  - [ ] Include `code elements` where appropriate.
-  - [ ] Write the article in Markdown format.
+### Writing Structure
+- [ ] Use short sentences and paragraphs, and include bucket brigades.
+- [ ] Include more than two descriptive H2 headings to organize content.
+- [ ] Capitalize headings according to the AP Stylebook ([use this tool](https://capitalizemytitle.com/style/AP/))
+- [ ] Include an introduction with at least two paragraphs before the first H2 section.
+- [ ] Use appropriate formatting (bold, italic, underline), notes, quotes, TLDRs, and key points.
+- [ ] Incorporate `code elements` and `Markdown format` where appropriate.
+- [ ] Ensure at least one visual element per “screen” of the article (screenshots, diagrams, tables, graphs, lists, sidenotes, blockquotes).
 
-- [ ] **Fact-Check**
-  - [ ] I have verified all facts and data points included in the article.
+### Fact-Checking
+- [ ] Verify all facts and data points included in the article.
 
-- [ ] **Assets**
-  - [ ] Save images in the `/assets` folder.
-  - [ ] Follow naming conventions: `YYYYMMDD_title_of_the_article_IMG_NAME_NO.png`.
+### Asset Management
+- [ ] Save images in the `/assets` folder.
+- [ ] Follow naming conventions: `YYYYMMDD_title_of_the_article_IMG_NAME_NO.png`.
+- [ ] (Optional) Create a GitHub repo for the code referenced in the article and share it.
 
-- [ ] **Interlinking**
-  - [ ] Use `CTRL+F` to search for relevant keywords on:
+### Interlinking
+- [ ] Use `CTRL+F` to search for relevant keywords in:
     - [Daytona Dotfiles Sitemap](https://www.daytona.io/sitemap-dotfiles.xml)
     - [Daytona Definitions Sitemap](https://www.daytona.io/sitemap-definitions.xml)
-  - [ ] Interlink keywords using the appropriate URLs.
+- [ ] Interlink keywords using the appropriate URLs.
 
-- [ ] **Glossary/Definitions**
-  - [ ] Identify and mark new terms that could be added to the Definitions page.
+### Glossary/Definitions
+- [ ] Create new definition in `/defitnitions` folder.
 
-- [ ] **Review and Edit**
-  - [ ] Read the article out loud to catch any awkward phrasing.
-  - [ ] Run the draft through [Grammarly](https://grammarly.com) or a similar tool to correct grammar and spelling errors.
-  - [ ] Double-check adherence to the style guide and repository guidelines.
+### Review and Edit
+- [ ] Ensure articles address the needs of the target audience and their search intent.
+- [ ] Read the article out loud to catch any awkward phrasing.
+- [ ] Run the draft through [Grammarly](https://grammarly.com) or a similar grammar tool.
+- [ ] Double-check adherence to the style guide and repository guidelines.

README.md

@@ -111,7 +111,7 @@ Remember, good writing is good writing, regardless of how it's produced. Our goa
 5. If multiple PRs are submitted by different individuals, we will typically prioritize those that demonstrate the clearest and most well-crafted writing.
 
 ### Editing Process
-- If the PR meets our standards, the issue will be assigned, and the editing process will commence.
+- If the PR meets our standards, the issue will be assigned to you, and the editing process will commence.
 - Articles undergo up to two rounds of editing.
 - Use tools like [Grammarly](https://grammarly.com), [Hemingway App](https://hemingwayapp.com/) and [LanguageTool](https://languagetool.org/) for initial proofreading.
 - Respond promptly to editorial feedback and make necessary revisions.