diff --git a/book/metadata.md b/book/metadata.md
index f6b5ddcb52d..d29fc753ba2 100644
--- a/book/metadata.md
+++ b/book/metadata.md
@@ -40,10 +40,10 @@ The span "start" and "end" here refer to where the underline will be in the line
 
 ## Custom Metadata
 
-You can attach arbitrary metadata to pipeline data using the [`metadata set`](/commands/docs/metadata_set.md) command with the `--merge` flag:
+You can attach arbitrary metadata to pipeline data using the [`metadata set`](/commands/docs/metadata_set.md) command with the optional closure parameter:
 
 ```nu
-"data" | metadata set --merge {custom_key: "custom_value"}
+"data" | metadata set { merge {custom_key: "custom_value"} }
 ```
 
 ## HTTP Response Metadata
diff --git a/book/special_variables.md b/book/special_variables.md
index a993a0a6108..e4ef7e64d52 100644
--- a/book/special_variables.md
+++ b/book/special_variables.md
@@ -26,7 +26,7 @@ The `$nu` constant is a record containing several useful values:
 - `cache-dir`: A directory for non-essential (cached) data.
 - `vendor-autoload-dirs`: A list of directories where third-party applications should install configuration files that will be auto-loaded during startup.
 - `user-autoload-dirs`: A list of directories where the user may create additional configuration files which will be auto-loaded during startup.
-- `temp-dir`: A path for temporary files that should be writeable by the user.
+- `temp-dir`: A path for temporary files that should be writable by the user.
 - `pid`: The PID of the currently running Nushell process.
 - `os-info`: Information about the host operating system.
 - `startup-time`: The amount of time (in duration) that it took for Nushell to start and process all configuration files.