cleanup, docs

site/doc/pages/ob_get.txt

@@ -2,15 +2,19 @@
 String ob_get()
 
 :params
-return value : content of the current output buffer
+return value : the current buffer's contents
+
+:content
+Returns the current output buffer's contents WITHOUT discarding the buffer, so more output can still be appended. Use `ob_get_close()` when you also want to pop the buffer.
+
+:example
+ob_start();
+print("partial");
+String snapshot = ob_get();
+ob_close();
+print("snapshot was: ", snapshot, "\n");
 
 :see
 >ob
-
-:content
-Returns the contents of the current output buffer.
-
-Unlike `ob_get_close()`, this does not discard the buffer.
-
-:example
-print("ob_get example\n");
+ob_get_close
+ob_start