diff --git a/docs/examples/styles/opacity.css b/docs/examples/styles/opacity.css
index 86d3845bd..15d059480 100644
--- a/docs/examples/styles/opacity.css
+++ b/docs/examples/styles/opacity.css
@@ -24,6 +24,7 @@ Screen {
 
 Static {
     height: 1fr;
+    border: outer dodgerblue;
     background: lightseagreen;
     content-align: center middle;
     text-style: bold;
diff --git a/docs/styles/opacity.md b/docs/styles/opacity.md
index c954f1332..1ccff5458 100644
--- a/docs/styles/opacity.md
+++ b/docs/styles/opacity.md
@@ -40,7 +40,7 @@ This example shows, from top to bottom, increasing opacity values.
 ## CSS
 
 ```sass
-/* Set the text to be "half-faded" against the background of the widget */
+/* Fade the widget to 50% against its parent's background */
 Widget {
     opacity: 50%;
 }
@@ -49,6 +49,6 @@ Widget {
 ## Python
 
 ```python
-# Set the text to be "half-faded" against the background of the widget
+# Fade the widget to 50% against its parent's background
 widget.styles.opacity = "50%"
 ```