diff --git a/docs/painless/painless-lang-spec/painless-statements.asciidoc b/docs/painless/painless-lang-spec/painless-statements.asciidoc
index b9aceed9cf097..0c4e6bcd976c6 100644
--- a/docs/painless/painless-lang-spec/painless-statements.asciidoc
+++ b/docs/painless/painless-lang-spec/painless-statements.asciidoc
@@ -12,6 +12,8 @@ control flow statements] except the `switch` statement.
 ---------------------------------------------------------
 if (doc[item].size() == 0) {
   // do something if "item" is missing
+} else if (doc[item].value == 'something') {
+  // do something if "item" value is: something
 } else {
   // do something else
 }
@@ -26,6 +28,23 @@ Painless also supports the `for in` syntax from Groovy:
 [source,painless]
 ---------------------------------------------------------
 for (item : list) {
-  ...
+  // do something
 }
 ---------------------------------------------------------
+
+===== While
+[source,painless]
+---------------------------------------------------------
+while (ctx._source.item < condition) {
+  // do something
+}
+---------------------------------------------------------
+
+===== Do-While
+[source,painless]
+---------------------------------------------------------
+do {
+  // something
+}
+while (ctx._source.item < condition)
+---------------------------------------------------------