docs: update developers overview and move security audits

developers/README.md

@@ -1,17 +1,17 @@
----
-description: From the Co-Founders
----
+# Welcome to ALEX Developer Docs
 
-# 😀 What is ALEX?
+**ALEX** is building the financial infrastructure on Bitcoin by combining Bitcoin L1 with Stacks L2 to unlock smart contract capabilities, DeFi primitives, and permissionless financial tools for Bitcoin users.
 
-The DeFi landscape is teeming with possibilities, and at the heart of it all, Bitcoin DeFi is set to take center stage. In the coming years, we expect a surge in growth revolving around Ordinals, BRC20 tokens, Bitcoin L2 in particular Stacks.
+Our architecture allows decentralized trading, cross-chain swaps, yield generation, and more — all secured by Bitcoin and powered by Stacks. With Ordinals, BRC-20s, and Layer 2 innovation accelerating, ALEX is shaping the future of Bitcoin DeFi.
 
-A quick retrospect shows how Ordinals have brilliantly showcased the potential of the Bitcoin blockchain. This revolutionary platform has turned the table, illustrating that Bitcoin’s ledger is more than just a settlement layer. Yet, to build a truly meaningful DeFi ecosystem on Bitcoin, transactions are only one piece of the puzzle. We need a competent smart contract and computing layer to complete the picture. That’s where Stacks steps in. The domino effect triggered by Ordinals has kindled an era where we expect Bitcoin’s Layer 1 (L1) asset issuance to skyrocket. Coupled with Stacks’ prowess in handling DeFi and other economic activities, we see a flourishing ecosystem set for the years ahead. 
+## About
 
-At ALEX, we’re not mere spectators. We’re an integral part of this vibrant, multi-year growth story. Our aim? To deliver a top-notch DeFi platform that caters to the next-gen Bitcoin users, innovators, and the broader ecosystem.
+This documentation is designed for developers building on or integrating with the ALEX ecosystem. Here you'll find:
 
-So, in essence, ALEX is a concentrated bet on this view of Bitcoin Finance. 
+🏗️ [Deployment information and contract addresses](developers/protocol-contracts/README.md)
 
-Presently, a good number of BRC-20s may appear to be meme coins, but we foresee a significant shift. We are witnessing more established projects considering BRC20 issuance. Moreover, numerous other projects we are in discussion with are considering issuing BRC20 tokens to augment their existing tokenomics and tap into a new audience. Some may argue that Bitcoin began its journey as a “meme” coin, with its initial purpose being to buy pizza amongst friends. However, the essential query is whether the technology enabling the creation of such meme coins can transcend that purpose. We are confident that BRC20 and Ordinals hold a greater potential than just being meme coins. 
+🧬 [Integration guides](developers/api-references.md)
 
-Our vision at ALEX is to dissolve the barrier between Bitcoin L1 and L2 to create a seamless Bitcoin DeFi experience. The relationship between Bitcoin and Stacks is fundamentally different from that of Ethereum and e.g. Arbitrum. In the Bitcoin-Stacks pair, L2 equips L1 with smart contract capabilities, while in the Ethereum-Arbitrum duo, both L1 and L2 possess their independent smart contract functionalities. Therefore, a true Bitcoin DeFi experience isn’t about users having to choose between L1 and L2. Instead, it’s about Bitcoin asset holders experiencing DeFi on L1 with L2 running smart contracts unobtrusively in the background. ALEX is not simply adapting to the emerging Bitcoin DeFi landscape — we’re actively shaping it. We’re steadfast in our belief that our efforts will continue to herald an exciting new epoch for Bitcoin DeFi, introducing the benefits of decentralized trading to an even wider audience. And by doing so, we’re facilitating the next generation of Bitcoin users to flourish within this rapidly evolving ecosystem.
+🏛️ [Smart contracts documentation](developers/protocol-contracts/README.md)
+
+🛡️ [Security audit reports](developers/security-audit.md)

developers/SUMMARY.md

@@ -27,7 +27,7 @@
   * [amm-pool-v3.clar](developers/protocol-contracts/amm-pool-v3.clar.md)
   * [self-listing-helper-v3a.clar](developers/protocol-contracts/self-listing-helper-v3a.clar.md)
 * [ALEX DAO](developers/alex-dao.md)
-* [Security Audits]()
+* [Security Audits](developers/security-audit.md)
 
 ## Resources
 

users/SUMMARY.md

@@ -58,7 +58,7 @@ Please do not remove the "What is New?" section, just hide it.
 
 ## Security
 
-* [✅ Audits](resources/security-audit.md)
+* [✅ Audits](../developers/developers/security-audit.md)
 * [🐛 Bug Bounties](resources/bug-bounty.md)
 
 ## Helpful Concepts