diff --git a/docs/source/index.rst b/docs/source/index.rst
index 3d042efe9..312bc831e 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -5,6 +5,8 @@
:target: ./.static/img/threshold_logo_purple.png
+`Welcome `_ to the Threshold Network!
+
Introduction
=============
@@ -91,6 +93,12 @@ Whitepapers
*by David Nuñez - NuCypher*
+.. toctree::
+ :maxdepth: 1
+ :caption: Threshold
+
+ threshold/threshold_overview
+
.. toctree::
:maxdepth: 1
:caption: Staking
diff --git a/docs/source/threshold/threshold_overview.rst b/docs/source/threshold/threshold_overview.rst
new file mode 100644
index 000000000..34d5fd371
--- /dev/null
+++ b/docs/source/threshold/threshold_overview.rst
@@ -0,0 +1,46 @@
+.. _threshold_overview:
+
+Legacy NU Stakes
+----------------
+
+As part of the merger to the Threshold Network, if you have an existing legacy NU stake,
+you can now withdraw it (and then upgrade the liquid tokens to T and stake). If you are
+subject to a vesting agreement, your unvested stake will not be immediately withdrawable
+but you can still stake it in Threshold!
+
+Both of these options are available from the NU dashboard: https://stake.nucypher.network/manage
+* Withdraw available NU stake: https://stake.nucypher.network/manage/withdraw
+* Stake unvested NU on Threshold: https://stake.nucypher.network/manage/stake
+
+
+Upgrading to T
+--------------
+
+The Threshold Network Token (`T `_) is
+the work token for staking on the Threshold Network, and
+allows for participation in `DAO governance `_.
+
+The `Threshold Network dashboard `_ for users to upgrade to T.
+
+The upgrade from NU to T is also available via directly interacting with the vending machine smart contracts
+deployed on mainnet. The NU -> T vending machine contract address is https://etherscan.io/address/0x1CCA7E410eE41739792eA0A24e00349Dd247680e.
+
+.. note::
+
+ 1 NU = 3.259242493160745 T
+
+
+.. note::
+
+ The vending machine contract uses a static conversion ratios and remain available indefinitely, so
+ please be safe, take your time, and confirm everything!
+
+
+T Supply Details
+----------------
+
+* 10B initial supply
+
+ * 4.5B allocated to NU holders
+ * 4.5B allocated to KEEP holders
+ * 1B allocated to Threshold DAO