From 8216d2be98ae5e12d9a8d62bfacdf98d2dfb6941 Mon Sep 17 00:00:00 2001
From: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
Date: Thu, 4 Aug 2022 15:37:29 +0900
Subject: [PATCH] Handbook - Digital Experience housekeeping (#7048)

README:
- fixed broken link for "how to submit and publish an article

How to submit and publish an article:
- added links to "Article formatting guide" and "Markdown guide"

Article formatting guide:
- added link to Markdown guide
---
 handbook/digital-experience/README.md                       | 2 +-
 handbook/digital-experience/article-formatting-guide.md     | 6 ++++--
 .../how-to-submit-and-publish-an-article.md                 | 5 +++++
 3 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/handbook/digital-experience/README.md b/handbook/digital-experience/README.md
index fd840c7f12..0f36056dde 100644
--- a/handbook/digital-experience/README.md
+++ b/handbook/digital-experience/README.md
@@ -26,7 +26,7 @@ Detail the minimum time needed for new or updated content to be live (published)
 
 | Content | To publish | To revise (for editors) | Timeframe |
 |:------ |:-----------------|:-------------------------------|-----------|
-| Articles | **Queued** – see [Process for submitting and publishing articles](./process-for-submitting-and-publishing-articles). | **Absorb** (pair or feedback as needed) – see [How to edit articles, release posts, and press releases](#how-to-edit-articles-release-posts-and-press-releases). | three business days |
+| Articles | **Queued** – see [How to submit and publish an article](./how-to-submit-and-publish-an-article). | **Absorb** (pair or feedback as needed) – see [How to edit articles, release posts, and press releases](#how-to-edit-articles-release-posts-and-press-releases). | three business days |
 | Ads | **Gated**. Request review from Digital Experience – see _(TODO: Creating an ad campaign)_. | **Feedback** or **pair** | five business days |
 | Docs | **Gated**. Request review from Desmi Dizney – see _(TODO: Adding to the docs)_. | **Absorb** – see [How to edit Markdown pull requests for the docs](#how-to-edit-markdown-pull-requests-for-the-docs). For non-grammar-related revisions: **Feedback** or **pair** with contributor, and request review from the [on-call engineer](https://fleetdm.com/handbook/engineering#oncall-rotation). | two business days |
 | Docs (REST API) | **Gated**. Request review from Luke Heath – see _(TODO: Adding to the docs (REST API))_. | **Absorb** – see [How to edit recently merged Pull Requests for the handbook and docs](#how-to-edit-recently-merged-pull-requests-for-the-handbook). For non-grammar-related revisions: **Feedback** or **pair** with contributor, and request review from Luke Heath. | two business days |
diff --git a/handbook/digital-experience/article-formatting-guide.md b/handbook/digital-experience/article-formatting-guide.md
index 2f16ef13c9..5f5ec72c06 100644
--- a/handbook/digital-experience/article-formatting-guide.md
+++ b/handbook/digital-experience/article-formatting-guide.md
@@ -1,6 +1,8 @@
 # Article formatting guide
 
-To publish an article, you will need to create a Pull Request for a new file, formatted in Markdown (todo), in [https://github.com/fleetdm/fleet/tree/main/articles](https://github.com/fleetdm/fleet/tree/main/articles).
+To publish an article, you will need to create a Pull Request for a new file, formatted in Markdown, in [https://github.com/fleetdm/fleet/tree/main/articles](https://github.com/fleetdm/fleet/tree/main/articles).
+
+> Learn how to write Fleet-flavored Markdown in our [Markdown guide](./markdown-guide).
 
 ### On this page
 - [Layout](#layout)
@@ -131,7 +133,7 @@ In the following example we will modify `title`, `text`, `primary-button-text`,
 
 ## Related pages
 - [How to submit and publish an article](./how-to-submit-and-publish-an-article.md)
-- Markdown guide (todo)
+- [Markdown guide](./markdown-guide)
 - Writing style guide (todo)
 
 <meta name="maintainedBy" value="mike-j-thomas">
diff --git a/handbook/digital-experience/how-to-submit-and-publish-an-article.md b/handbook/digital-experience/how-to-submit-and-publish-an-article.md
index 705cc0b8b2..91cf50c235 100644
--- a/handbook/digital-experience/how-to-submit-and-publish-an-article.md
+++ b/handbook/digital-experience/how-to-submit-and-publish-an-article.md
@@ -78,5 +78,10 @@ After your article is published, the Growth team will schedule your post to be p
 
 > Consider promoting your article on your personal channels to help achieve a bigger impact. Depending on the article, the Growth team may make a request in [#help-promote](https://fleetdm.slack.com/archives/C026W5TC10V) on Slack.
 
+## Related pages
+- [Article formatting guide](./article-formatting-guide)
+- [Markdown guide](./markdown-guide)
+- Writing style guide (todo)
+
 <meta name="maintainedBy" value="timmy-k">
 <meta name="title" value="How to submit and publish an article">
\ No newline at end of file