diff --git a/docs/cli/index.md b/docs/cli/index.md
index 2eb356369..c8f8d24b3 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/mise.usage.kdl b/mise.usage.kdl
index 66261a131..6f49ec232 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