From 61540d92b01d3b646757d514206c0c76213e8993 Mon Sep 17 00:00:00 2001
From: Mark Otto <markdotto@gmail.com>
Date: Sat, 28 Mar 2015 01:00:14 -0700
Subject: [PATCH] add docs and source comments on the 'broken' nature of our
 uls/ols

---
 docs/docs.scss | 2 +-
 docs/type.md   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/docs.scss b/docs/docs.scss
index b9ce5ca9cf..9983e28ca2 100644
--- a/docs/docs.scss
+++ b/docs/docs.scss
@@ -281,7 +281,7 @@ body {
     border: 1px solid lighten($brand-green, 30%);
   }
 
-  // Override markdown styles
+  // Override Markdown styles to restore values from `_type.scss`
   ul {
     padding: 0;
     margin-top: 0;
diff --git a/docs/type.md b/docs/type.md
index 4d79d97c37..03fbbc177d 100644
--- a/docs/type.md
+++ b/docs/type.md
@@ -68,7 +68,7 @@ Wrap `<blockquote>` around any <abbr title="HyperText Markup Language">HTML</abb
 
 ### Unordered
 
-A list of items in which the order does *not* explicitly matter.
+A list of items in which the order does *not* explicitly matter. **The broken display is intended** as Primer resets `<ul>`s and `<ol>`s for the time being. This will eventually be undone in the next major version.
 
 {% example html %}
 <ul>