review suggestions

Author: MichaelTrestman

docs/learn/chain-rate-limits.md

@@ -36,13 +36,6 @@ This rate limit prevents frequent changes to delegate take percentages.
 - Chain State Variable: `TxDelegateTakeRateLimit`
 - Error message: [`DelegateTxRateLimitExceeded`](../errors/subtensor.md#delegatetxratelimitexceeded)
 
-### Child key take rate limit
-
-This rate limit prevents the owner of a child hotkey from making frequent changes to the child key take percentages. This protects against rapid manipulation of child key relationships and ensures stability in the child key delegation system.
-
-- Rate Limit: 216,000 blocks (~30 days)
-- Chain State Variable: `TxChildkeyTakeRateLimit`
-- Error message: [`TxChildkeyTakeRateLimitExceeded`](../errors/subtensor.md#txchildkeytakeratelimitexceeded)
 
 ### Hotkey swap rate limit
 
@@ -123,6 +116,24 @@ This rate limit controls how frequently a user can perform staking operations (a
 - Rate Limit: 1 per block
 - Chain State Variable: `StakingOperationRateLimiter` (Bool, since limit is 1 operation)
 - Error message: [`StakingOperationRateLimitExceeded`](../errors/subtensor.md#stakingoperationratelimitexceeded)
+
+
+### Child hotkey operations rate limit
+
+This rate limit controls how frequently a parent hotkey can set or revoke child hotkeys on a specific subnet. Note that revoking children is implemented by calling `set_children` with an empty list, so both operations share the same rate limit.
+
+- Rate Limit: 150 blocks (~30 minutes)
+- Source Code: [rate_limiting.rs](https://github.com/opentensor/subtensor/blob/main/pallets/subtensor/src/utils/rate_limiting.rs#L25-L28)
+- Error message: [`TxRateLimitExceeded`](../errors/subtensor.md#txratelimitexceeded)
+
+### Child key take rate limit
+
+This rate limit prevents the owner of a child hotkey from making frequent changes to the child key take percentages.
+
+- Rate Limit: 216,000 blocks (~30 days)
+- Chain State Variable: `TxChildkeyTakeRateLimit`
+- Error message: [`TxChildkeyTakeRateLimitExceeded`](../errors/subtensor.md#txchildkeytakeratelimitexceeded)
+
 ## Subnet-specific rate limits
 
 This section discusses rate limits that apply within a specific subnet on the network. These limits are typically configurable at the subnet level.

docs/validators/child-hotkeys.md

@@ -65,10 +65,10 @@ The child hotkey features are as follows:
 
 The following rate limits apply for child hotkeys:
 
-- A child hotkey's take rate can only be adjusted once per 30 days.
-- One successful execution of `set_children` or `revoke_children` is allowed for every 720 blocks.
+- Setting or revoking children is allowed for every 150 blocks (~30 minutes).
+- A given child hotkey's take rate can only be adjusted once per 30 days.
 
-See [Rate Limits in Bittensor](../learn/chain-rate-limits.md).
+See [Rate Limits in Bittensor: Child hotkey operations rate limit](../learn/chain-rate-limits#child-hotkey-operations-rate-limit).
 
 ## Minimum stake requirement
 
@@ -176,7 +176,7 @@ btcli stake child revoke
 ```
 
 ### Example
-
+<!-- this is still the wrong syntax! Let's make sure all the examples are still valid-->
 ```bash
 btcli stake revoke_children \
   --netuid 4 \