diff --git a/pages/_docs/avatars.md b/pages/_docs/avatars.md
index 61b8e1c50..966329320 100644
--- a/pages/_docs/avatars.md
+++ b/pages/_docs/avatars.md
@@ -48,7 +48,7 @@ You can also use icons in avatars.
 
 ### Avatar initials color
 
-Customize the color of the avatars' background. You can click You can click [here]({% docs_url colors %}) to see the list of available colors.
+Customize the color of the avatars' background. You can click [here]({% docs_url colors %}) to see the list of available colors.
 
 {% example html wrapper=avatar-list %}
 {% include ui/avatar.html placeholder="AB" color="green" %}
diff --git a/pages/_docs/flags.md b/pages/_docs/flags.md
index 3928630c2..43394535c 100644
--- a/pages/_docs/flags.md
+++ b/pages/_docs/flags.md
@@ -15,12 +15,7 @@ done: true
 
 ### Flag sizes
 
-Change the flag size. 
-<ul>
-    <li><code>xl</code> - large</li>
-    <li><code>mr</code> - big</li>
-    <li><code>md</code> - medium</li>
-</ul>
+Using Bootstrap’s typical naming structure, you can create a standard flag, or scale it up to different sizes based on what’s needed.
 
 {% example html %}
 {% include ui/flag.html flag="pl" class="flag-size-xl mr-1" %}
@@ -31,7 +26,7 @@ Change the flag size.
 
 ### Types
 
-To set the flag of the country you want add a class flag-(country name). For example to create a flag of Andorra your class should look like this: flag-ad.
+To set the flag of the country you want add a class `flag-(country name)`. For example to create a flag of Andorra your class should look like this: `.flag-ad`.
 
 <table>
 {% for flag in site.data.flags %}