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 832e627b4..43394535c 100644
--- a/pages/_docs/flags.md
+++ b/pages/_docs/flags.md
@@ -15,11 +15,7 @@ done: true
 
 ### Flag sizes
 
-Change the flag size. 
-
-- `xl` - large
-- `mr` - big
-- `md` - medium
+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" %}
@@ -30,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 %}