diff --git a/docs/reference/admonitions.md b/docs/reference/admonitions.md
index d8f2ae9b3..4da65114b 100644
--- a/docs/reference/admonitions.md
+++ b/docs/reference/admonitions.md
@@ -287,7 +287,7 @@ only the `inline` modifier.
 
     Use `inline` to align to the left (right for rtl languages).
 
-__Important__: Admonitions that use the `inline` modifiers _must_ be declared
+__Important__: admonitions that use the `inline` modifiers _must_ be declared
 prior to the content block you want to place them beside. If there's
 insufficient space to render the admonition next to the block, the admonition
 will stretch to the full width of the viewport, e.g. on mobile viewports.
diff --git a/docs/upgrade.md b/docs/upgrade.md
index a03a94650..ebcee2a3c 100644
--- a/docs/upgrade.md
+++ b/docs/upgrade.md
@@ -602,7 +602,7 @@ matches the new structure:
 - Support for displaying stars and forks for GitLab repositories
 - Support for scroll snapping of sidebars and search results
 - Reduced HTML and CSS footprint due to deprecation of Internet Explorer support
-- Slight facelifting of some UI elements (Admonitions, tables, ...)
+- Slight facelifting of some UI elements (admonitions, tables, ...)
 
   [CSS variables]: setup/changing-the-colors.md#custom-colors
   [icon integration]: reference/icons-emojis.md#search