Update resource-limits-fees.mdx (#746)

* Update resource-limits-fees.mdx Add context around the phased approach * formatting and linting --------- Co-authored-by: Elliot Voris <[email protected]>
stellar-deprecated · Feb 23, 2024 · 0a6834b · 0a6834b
1 parent 4aa26d4
commit 0a6834b
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/docs/reference/resource-limits-fees.mdx b/docs/reference/resource-limits-fees.mdx
@@ -5,6 +5,8 @@ title: Resource Limits & Fees
 
 ## Resource Limits
 
+Soroban introduces smart contracts, marking the most transformative upgrade to the Stellar network to date. To maintain network performance, the ecosystem has decided to upgrade the network in a phased approach where network capacity is increased gradually over time. See [this blog post](https://stellar.org/blog/developers/the-stellar-network-s-phased-rollout-of-smart-contracts-the-road-to-mainnet) for more details and [discord](https://discord.com/invite/zVYdY3ktTn) for current status.
+
 | Network Setting                                    | Phase 0 (current)                          | Phase 1                                                                                                |
 | :------------------------------------------------- | :----------------------------------------- | :----------------------------------------------------------------------------------------------------- |
 | Soroban Txn per ledger                             | 1                                          | 100                                                                                                    |
@@ -27,6 +29,8 @@ The ledger rent cost ('Write 1KB' entries in the table) is based on the write fe
 
 ### Phase 0 (current)
 
+Phase 0 is meant for network operators to observe and ensure network stability. While you may be able to deploy simple contracts, Mainnet in Phase 0 is not designed for contract development or deployment. Testnet is better suited for this purpose.
+
 | Network Setting                               | Phase 0 Cost (stroops)  |
 | :-------------------------------------------- | :---------------------- |
 | 10,000 instructions                           | 100 (1,000,000/tx)      |
@@ -48,6 +52,8 @@ The ledger rent cost ('Write 1KB' entries in the table) is based on the write fe
 
 ### Phase 1
 
+Phase 1 is meant for network operators to monitor network performance under use. While you'll be able to deploy contracts, Mainnet in Phase 1 has limited throughput. You should not expect more than 1 smart contract transaction per ledger. You can expect throughput to be gradually increased based on network performance and user (your) feedback. See [this blog post](https://stellar.org/blog/developers/the-stellar-network-s-phased-rollout-of-smart-contracts-the-road-to-mainnet) for more details and share your feedback in [discord](https://discord.com/invite/zVYdY3ktTn).
+
 | Network setting                               | Phase 1 Cost (stroops)                                                                                           |
 | :-------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- |
 | 10,000 instructions                           | 25 (250,000/max tx)                                                                                              |