diff --git a/docs/src/cargo-toml-configuration.md b/docs/src/cargo-toml-configuration.md
index c638e9ac..637680ef 100644
--- a/docs/src/cargo-toml-configuration.md
+++ b/docs/src/cargo-toml-configuration.md
@@ -18,6 +18,10 @@ The available configuration options and their default values are shown below:
 # be set to an array of strings which are explicit arguments to pass to
 # `wasm-opt`. For example `['-Os']` would optimize for size while `['-O4']`
 # would execute very expensive optimizations passes
+#
+# In most cases, the `-O[X]` flag is enough. However, if you require extreme
+# optimizations, see the full list of `wasm-opt` optimization flags
+# https://github.com/WebAssembly/binaryen/blob/version_117/test/lit/help/wasm-opt.test
 wasm-opt = ['-O']
 
 [package.metadata.wasm-pack.profile.dev.wasm-bindgen]
diff --git a/src/install/mod.rs b/src/install/mod.rs
index f771b2e6..bbc9a645 100644
--- a/src/install/mod.rs
+++ b/src/install/mod.rs
@@ -203,7 +203,7 @@ pub fn prebuilt_url_for(tool: &Tool, version: &str, arch: &Arch, os: &Os) -> Res
         Tool::WasmOpt => {
             Ok(format!(
         "https://github.com/WebAssembly/binaryen/releases/download/{vers}/binaryen-{vers}-{target}.tar.gz",
-        vers = "version_117",
+        vers = "version_117", // Make sure to update the version in docs/src/cargo-toml-configuration.md as well
         target = target,
             ))
         }