diff --git a/docs/bun.lockb b/docs/bun.lockb
index 3298355f67..f210b1646d 100755
Binary files a/docs/bun.lockb and b/docs/bun.lockb differ
diff --git a/docs/cli/index.md b/docs/cli/index.md
index 2eb3563696..c8f8d24b3c 100644
--- a/docs/cli/index.md
+++ b/docs/cli/index.md
@@ -1026,7 +1026,7 @@ In .mise.toml, tasks take this form:
     outputs = ["dist/**/*.js"]
 
 Alternatively, tasks can be defined as standalone scripts.
-These must be located in the `.mise/tasks` directory.
+These must be located in the `.mise/tasks`, `mise/tasks` or `.config/mise/tasks` directory.
 The name of the script will be the name of the tasks.
 
     $ cat .mise/tasks/build<<EOF
@@ -1110,8 +1110,9 @@ Examples:
 ```text
 Updates mise itself
 
-Uses the GitHub Releases API to find the latest release and binary
-By default, this will also update any installed plugins
+Uses the GitHub Releases API to find the latest release and binary.
+By default, this will also update any installed plugins.
+Uses the `GITHUB_API_TOKEN` environment variable if set for higher rate limits.
 
 Usage: self-update [OPTIONS] [VERSION]
 
@@ -1456,7 +1457,7 @@ In .mise.toml, tasks take this form:
     outputs = ["dist/**/*.js"]
 
 Alternatively, tasks can be defined as standalone scripts.
-These must be located in the `.mise/tasks` directory.
+These must be located in the `.mise/tasks`, `mise/tasks` or `.config/mise/tasks` directory.
 The name of the script will be the name of the tasks.
 
     $ cat .mise/tasks/build<<EOF
diff --git a/docs/package.json b/docs/package.json
index e8478f8247..75f689e7f4 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -3,7 +3,7 @@
   "private": true,
   "type": "module",
   "devDependencies": {
-    "vitepress": "1.2.2"
+    "vitepress": "1.2.3"
   },
   "scripts": {
     "docs:dev": "vitepress dev",
diff --git a/mise.usage.kdl b/mise.usage.kdl
index 66261a1317..6f49ec2324 100644
--- a/mise.usage.kdl
+++ b/mise.usage.kdl
@@ -780,7 +780,7 @@ In .mise.toml, tasks take this form:
     outputs = ["dist/**/*.js"]
 
 Alternatively, tasks can be defined as standalone scripts.
-These must be located in the `.mise/tasks` directory.
+These must be located in the `.mise/tasks`, `mise/tasks` or `.config/mise/tasks` directory.
 The name of the script will be the name of the tasks.
 
     $ cat .mise/tasks/build<<EOF
@@ -828,8 +828,9 @@ The name of the script will be the name of the tasks.
 cmd "self-update" help="Updates mise itself" {
     long_help r"Updates mise itself
 
-Uses the GitHub Releases API to find the latest release and binary
-By default, this will also update any installed plugins"
+Uses the GitHub Releases API to find the latest release and binary.
+By default, this will also update any installed plugins.
+Uses the `GITHUB_API_TOKEN` environment variable if set for higher rate limits."
     flag "-f --force" help="Update even if already up to date"
     flag "--no-plugins" help="Disable auto-updating plugins"
     flag "-y --yes" help="Skip confirmation prompt"
@@ -1053,7 +1054,7 @@ In .mise.toml, tasks take this form:
     outputs = ["dist/**/*.js"]
 
 Alternatively, tasks can be defined as standalone scripts.
-These must be located in the `.mise/tasks` directory.
+These must be located in the `.mise/tasks`, `mise/tasks` or `.config/mise/tasks` directory.
 The name of the script will be the name of the tasks.
 
     $ cat .mise/tasks/build<<EOF