doc updates

website/docs/oracle/architecture.mdx

@@ -10,7 +10,7 @@ import OracleMetrics from "/idl/types/OracleMetrics.md";
 
 A Switchboard oracle is a Node.js container that sits between the Solana blockchain and the internet and waits for update requests from an oracle queue. An oracle queue assigns updates to oracles in a round robin fashion.
 
-An oracle account is a program derived address (PDA) between the oracle queue it’s being initialized for, as well as the authority public key which will control it. Before an oracle is granted permissions to use a queue, it must transfer the minimum stake amount, set by the queue, to its escrow wallet.
+An oracle account is a program derived address (PDA) between the oracle queue it’s being initialized for, as well as the oracles staking wallet. Before an oracle is granted permissions to use a queue, it must transfer the minimum stake amount, set by the queue, to its staking wallet.
 
 ## Staking
 
@@ -18,7 +18,7 @@ An oracle is required to transfer `queue.minStake` tokens to its staking wallet,
 
 ## Heartbeat
 
-An oracle is required to heartbeat on-chain, `oracle.lastHeartbeat`, in order to join the queue and be assigned update request. An oracle must heartbeat before the queue's specified `queue.oracleTimeout` or it will be removed from the queue.
+An oracle is required to heartbeat on-chain in order to join the queue and be assigned update request. An oracle must heartbeat before the queue's specified `queue.oracleTimeout` or it will be removed from the queue by the queue's garbage collector.
 
 ## Metrics
 

website/docs/oracle/operator/requirements.mdx

@@ -14,7 +14,7 @@ You can find the latest Switchboard oracle image on [DockerHub](https://hub.dock
 
 A Switchboard oracle should be hosted in a highly available environment with some level of redundancy and fail over to prevent outages, although oracles are not deducted for being offline.
 
-Currently the Switchboard oracle is a single threaded Node.js application with no strict hardware requirements. At the very minimum a node should have:
+At the very minimum a node should have:
 
 - 4gb RAM
 - 3.0 Ghz CPU

website/docs/queue/architecture.mdx

@@ -104,7 +104,9 @@ TODO:
 
 A queue can choose to create one or many cranks. A crank is a scheduling mechanism that allows data feeds to request periodic updates. A crank can be turned by anyone, and if successful, the crank turner will be rewarded for jump starting the system.
 
-A data feed is only permitted to join a crank if it has sufficient permissions (as detailed above) and the crank has available capacity. Data feeds on a crank are ordered by their next available update time with some level of jitter, providing a maximum update interval of 2 × a data feed's `aggregator.minUpdateDelaySeconds`. This is to mitigate oracles being assigned to the same aggregator update request, making a feed vulnerable to a malicious oracle.
+A data feed is only permitted to join a crank if it has sufficient permissions (as detailed above) and the crank has available capacity. Data feeds on a crank are ordered by their next available update time with some level of jitter to mitigate oracles being assigned to the same update request upon each iteration of the queue, which makes them susceptible to a malicous oracle. The maximum update interval for a feed on a crank is based on its `aggregator.minUpdateDelaySeconds` and can be calculated by:
+
+$I_{Max} (seconds) = 15\quad\% \quad I_{minUpdateDelaySeconds}$
 
 ## Economic Security
 
@@ -112,7 +114,7 @@ An oracle queue uses economic incentives to entice oracles to act honestly, whic
 
 ### Stake
 
-The queue's `queue.minStake` is the number of tokens required by an oracle to heartbeat on a queue. If an oracle's staking wallet falls below the minStake requirement, it is removed from the queue.
+The queue's `queue.minStake` is the raw token amount in the token mints base unit (_Ex: lamports or satoshis_) required by an oracle to heartbeat on a queue. If an oracle's staking wallet falls below the minStake requirement, it is removed from the queue.
 
 DeFi protocols with a significant Total Value Locked (TVL) should require oracles with a higher minimum stake to fulfill their update request. Oracles with a higher degree of _skin-in-the-game_ have a greater incentive to respond honestly.
 

website/docs/queue/private-queues.mdx

@@ -11,9 +11,7 @@ Switchboard provides the ability to create your own queue with your own set of o
 
 ## Variable Expansion
 
-Oracles can be provided a `configs.json` file to store various configurations needed to execute job definitions. If an oracle encounters a job definition with a variable, it will parse the `configs.json` and embed the value in the job definition.
-
-Oracles can embed API Keys on a per job basis by specifying the jobAccount public key or by using an asterisk character to use the variable for multiple job definitions. **_Wildcard variables should use a unique name to prevent incorrect substitution._**
+Oracles can be provided a `configs.json` file to store various configurations needed to execute job definitions. If an oracle encounters a job definition with a variable, it will parse the `configs.json` and embed the value in the job definition. API keys should be specified in the config under the Job Account public key to prevent a malicous feed from leaking an API key.
 
 ```json title="configs.json"
 {
@@ -30,7 +28,9 @@ Oracles can embed API Keys on a per job basis by specifying the jobAccount publi
 }
 ```
 
-:::caution
+:::danger
+
+**_Wildcard variables should only be used for testing purposes and never in production._**
 
 Private queue's should **_ALWAYS_** have `unpermissionedFeedsEnabled` set to false. Allowing unpermitted feeds could result in a malicious actor creating a job definition that leaks your sensitive API keys.