From bf1352c0e47b9e8f736b70b7e285d2c7f32447a6 Mon Sep 17 00:00:00 2001
From: epriestley <git@epriestley.com>
Date: Tue, 28 Jun 2016 14:32:59 -0700
Subject: [PATCH] Document the "---" rule in Remarkup

Summary: Fixes T11228.

Test Plan: {F1704113}

Reviewers: chad

Reviewed By: chad

Maniphest Tasks: T11228

Differential Revision: https://secure.phabricator.com/D16186
---
 src/docs/user/userguide/remarkup.diviner | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/src/docs/user/userguide/remarkup.diviner b/src/docs/user/userguide/remarkup.diviner
index 8c6c7e1bec..33d8a136df 100644
--- a/src/docs/user/userguide/remarkup.diviner
+++ b/src/docs/user/userguide/remarkup.diviner
@@ -307,6 +307,28 @@ the rendered result. For example, this callout uses `(NOTE)`:
 (NOTE) Dr. Egon Spengler is the best resource for additional proton pack
  questions.
 
+
+Dividers
+========
+
+You can divide sections by putting three or more dashes on a line by
+themselves. This creates a divider or horizontal rule similar to an `<hr />`
+tag, like this one:
+
+---
+
+The dashes need to appear on their own line and be separated from other
+content. For example, like this:
+
+```
+This section will be visually separated.
+
+---
+
+On an entirely different topic, ...
+```
+
+
 = Linking URIs =
 
 URIs are automatically linked: http://phabricator.org/