diff --git a/markdown/bitburner.ns.hack.md b/markdown/bitburner.ns.hack.md
index d2fbe563b..25846ca97 100644
--- a/markdown/bitburner.ns.hack.md
+++ b/markdown/bitburner.ns.hack.md
@@ -33,7 +33,7 @@ Function that is used to try and hack servers to steal money and gain hacking ex
 
 A script can hack a server from anywhere. It does not need to be running on the same server to hack that server. For example, you can create a script that hacks the `foodnstuff` server and run that script on any server in the game.
 
-A successful `hack()` on a server will raise that server’s security level by 0.002.
+A successful `hack()` on a server will raise that server’s security level by 0.002 per thread. You can use [hackAnalyzeSecurity](./bitburner.ns.hackanalyzesecurity.md) to calculate the security increase for a number of threads.
 
 ## Example
 
diff --git a/markdown/bitburner.ns.weaken.md b/markdown/bitburner.ns.weaken.md
index dcf77f5ad..f5ffb1674 100644
--- a/markdown/bitburner.ns.weaken.md
+++ b/markdown/bitburner.ns.weaken.md
@@ -29,7 +29,9 @@ A promise that resolves to the value by which security was reduced.
 
 RAM cost: 0.15 GB
 
-Use your hacking skills to attack a server’s security, lowering the server’s security level. The runtime for this function depends on your hacking level and the target server’s security level when this function is called. This function lowers the security level of the target server by 0.05.
+Use your hacking skills to attack a server’s security, lowering the server’s security level. The runtime for this function depends on your hacking level and the target server’s security level when this function is called.
+
+This function usually lowers the security level of the target server by 0.05 per thread, and only in unusual situations does it do less. Use [weakenAnalyze](./bitburner.ns.weakenanalyze.md) to determine the exact value.
 
 Like [hack](./bitburner.ns.hack.md) and [grow](./bitburner.ns.grow.md)<!-- -->, `weaken` can be called on any server, regardless of where the script is running. This function requires root access to the target server, but there is no required hacking level to run the function.
 
diff --git a/src/ScriptEditor/NetscriptDefinitions.d.ts b/src/ScriptEditor/NetscriptDefinitions.d.ts
index 471ef0ff3..273d6ae0a 100644
--- a/src/ScriptEditor/NetscriptDefinitions.d.ts
+++ b/src/ScriptEditor/NetscriptDefinitions.d.ts
@@ -5547,7 +5547,8 @@ export interface NS {
    * server to hack that server. For example, you can create a script that hacks the `foodnstuff`
    * server and run that script on any server in the game.
    *
-   * A successful `hack()` on a server will raise that server’s security level by 0.002.
+   * A successful `hack()` on a server will raise that server’s security level by 0.002 per thread. You can use
+   * {@link NS.hackAnalyzeSecurity | hackAnalyzeSecurity} to calculate the security increase for a number of threads.
    *
    * @example
    * ```js
@@ -5612,7 +5613,10 @@ export interface NS {
    *
    * Use your hacking skills to attack a server’s security, lowering the server’s security level.
    * The runtime for this function depends on your hacking level and the target server’s security
-   * level when this function is called. This function lowers the security level of the target server by 0.05.
+   * level when this function is called.
+   *
+   * This function usually lowers the security level of the target server by 0.05 per thread, and only in unusual
+   * situations does it do less. Use {@link NS.weakenAnalyze | weakenAnalyze} to determine the exact value.
    *
    * Like {@link NS.hack | hack} and {@link NS.grow| grow}, `weaken` can be called on any server, regardless of
    * where the script is running. This function requires root access to the target server, but