docs: Add more examples for toml tasks

docs/tasks/toml-tasks.md

@@ -27,8 +27,6 @@ dir = "{{cwd}}" # run in user's cwd, default is the project's base directory
 [tasks.lint]
 description = 'Lint with clippy'
 env = { RUST_BACKTRACE = '1' } # env vars for the script
-# specify a shell command to run the script with (default is 'sh -c')
-shell = 'bash -c'
 # you can specify a multiline script instead of individual commands
 run = """
 #!/usr/bin/env bash
@@ -134,7 +132,7 @@ run = 'cargo test {{option(name="file")}}'
 Flags are like options except they don't take values. They are defined in scripts with <span v-pre>
 `{{flag()}}`</span>.
 
-Example:
+Examples:
 
 ```toml
 [tasks.echo]
@@ -143,10 +141,125 @@ run = 'echo {{flag(name=("myflag")}}'
 # runs: echo true
 ```
 
+```toml
+[tasks.maybeClean]
+run = """
+if [ '{{flag(name='clean')}}' = 'true' ]; then
+  echo 'cleaning'
+fi
+"""
+# execute: mise run maybeClean --clean
+# runs: echo cleaning
+```
+
 - `name`: The name of the flag. This is used for help/error messages.
 
 The value will be `true` if the flag is passed, and `false` otherwise.
 
+## Shell / Shebang
+
+You can specify a shell command to run the script with (default is [`sh -c`](/configuration/settings.html#unix_default_inline_shell_args) or [`cmd /c`](/configuration/settings.html#windows_default_inline_shell_args)) or use a shebang:
+
+```toml
+[tasks.lint]
+shell = 'bash -c'
+run = "cargo clippy"
+```
+
+or use a shebang:
+
+```toml
+[tasks.lint]
+run = """
+#!/usr/bin/env bash
+cargo clippy
+"""
+```
+
+By using `shell` or `shebang`, you can run scripts in different languages:
+
+::: code-group
+
+```toml [python]
+[tools]
+python = 'latest'
+
+[tasks.python_task]
+run = """
+#!/usr/bin/env -S python
+for i in range(10):
+    print(i)
+"""
+```
+
+```toml [node]
+[tools]
+node = 'lts'
+
+[tasks.node_task]
+shell = 'node -e'
+run = [
+  "console.log('First line')",
+  "console.log('Second line')",
+]
+```
+
+```toml [bun]
+[tools]
+bun = 'latest'
+
+[tasks.bun_shell]
+shell = "bun -e"
+run = """
+// https://bun.sh/docs/runtime/shell
+import { $ } from "bun";
+const response = await fetch("https://example.com");
+await $`cat < ${response} | wc -c`; // 1256
+"""
+```
+
+```toml [deno]
+[tools]
+deno = 'latest'
+
+[tasks.deno_task]
+description = "Shows that you can use deno in a task"
+shell = 'deno eval' # or use a shebang: #!/usr/bin/env -S deno run
+run = """
+import ProgressBar from "jsr:@deno-library/progress";
+import { delay } from "jsr:@std/async";
+
+if (!confirm('Start download?')) {
+    Deno.exit(1);
+}
+
+const progress = new ProgressBar({ title:  "downloading:", total: 100 });
+let completed = 0;
+async function download() {
+  while (completed <= 100) {
+    await progress.render(completed++);
+    await delay(10);
+  }
+}
+await download();
+"""
+# ❯ mise run deno_task
+# [download_task] $ import ProgressBar from "jsr:@deno-library/progress";
+# Start download? [y/N] y
+# downloading: ...
+```
+
+```toml [ruby]
+[tools]
+ruby = 'latest'
+
+[tasks.ruby_task]
+shell = 'ruby -e'
+run = "puts 'Hello, world!'"
+```
+
+:::
+
 ## Windows
 
 You can specify an alternate command to run on Windows by using the `run_windows` key: