docs: document and add examples of expandGlob (#6404)

1 files changed, 25 insertions, 0 deletions

diff --git a/std/fs/README.md b/std/fs/README.md
index e0f0d85ce..612b1393f 100644
--- a/std/fs/README.md
+++ b/std/fs/README.md
@@ -196,3 +196,28 @@ import {
 writeFileStr("./target.dat", "file content"); // returns a promise
 writeFileStrSync("./target.dat", "file content"); // void
 ```
+
+### expandGlob
+
+Expand the glob string from the specified `root` directory and yield each result
+as a `WalkEntry` object.
+
+```ts
+import { expandGlob } from "https://deno.land/std/fs/mod.ts";
+
+for await (const file of expandGlob("**/*.ts")) {
+  console.log(file);
+}
+```
+
+### expandGlobSync
+
+Synchronous version of `expandGlob()`.
+
+```ts
+import { expandGlobSync } from "https://deno.land/std/fs/mod.ts";
+
+for (const file of expandGlobSync("**/*.ts")) {
+  console.log(file);
+}
+```