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>