diff --git a/pages/common/while.md b/pages/common/while.md
index 7bdb6fbb54..cb39b2e297 100644
--- a/pages/common/while.md
+++ b/pages/common/while.md
@@ -1,6 +1,6 @@
 # while
 
-> Simple shell loop.
+> Simple shell loop that repeats while the return value remains zero.
 > More information: <https://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#tag_18_09_04_09>.
 
 - Read `stdin` and perform an action on every line:
@@ -11,6 +11,6 @@
 
 `while :; do {{command}}; sleep 1; done`
 
-- Execute a command until it returns a non-zero value:
+- Execute a command until it fails:
 
 `while {{command}}; do :; done`