From 1fdcd065c120cc436ff7b81149965eafbcc0293d Mon Sep 17 00:00:00 2001
From: Victoria <4222953+lvpeschke@users.noreply.github.com>
Date: Fri, 20 Sep 2024 10:57:22 +0200
Subject: [PATCH] Add L1 to L2 upgrade decision tree (#1465)

* Create decision-tree.md

Add content from the [decision tree doc](https://docs.google.com/document/d/1_IGhGeVRSQYLZT9qfm66cagrM8Tgh1qZvyCEp9zSnes/edit) to the docs with HTML details to toggle relevant info while keeping it searchable.

* Add decision tree to FAQs

* Add decision tree to sidebar
---
 docs/cel2/decision-tree.md | 58 ++++++++++++++++++++++++++++++++++++++
 docs/cel2/faq.md           |  4 +++
 sidebars.js                |  5 ++++
 3 files changed, 67 insertions(+)
 create mode 100644 docs/cel2/decision-tree.md

diff --git a/docs/cel2/decision-tree.md b/docs/cel2/decision-tree.md
new file mode 100644
index 0000000000..ad95701d84
--- /dev/null
+++ b/docs/cel2/decision-tree.md
@@ -0,0 +1,58 @@
+---
+title: Cel2 Decision Tree
+description: Not sure what you need to do to migrate from Celo L1 to Celo L2?
+---
+
+<details>
+  <summary>I run a node</summary>
+  
+  Follow the [node upgrade instructions](docs/cel2/l2-operator-guide.md).
+
+</details>
+<details>
+  <summary>I use or need a node provider</summary>
+
+  The following node providers will be available shortly after the migration to Cel2:
+
+  - [Quicknode](https://www.quicknode.com/chains/celo) (not yet verified)
+  - [Infura](https://www.infura.io/networks/celo) (not yet verified)
+  - [DSRV](https://drpc.org/chainlist/celo) (not yet verified)
+
+
+  If none of the above work for you, you can use cLabs best effort hosted node: [Forno](https://docs.celo.org/network/node/forno).
+</details>
+<details>
+  <summary>I use ContractKit or Fee Abstraction (ERC-20 gas tokens)</summary>
+
+  Recommended versions for SDK and libraries:
+  - [@celo/connect >=6.1.0](https://www.npmjs.com/package/@celo/connect)
+  - [@celo/contractkit >=8.1.1](https://www.npmjs.com/package/@celo/contractkit)
+  - [@celo/celocli >=5.1.1](https://www.npmjs.com/package/@celo/celocli)
+  - [@viem >=2](https://www.npmjs.com/package/viem)
+  
+  <details>
+  <summary>I need more information on ContractKit...</summary>
+    
+  Have a look at the [ContractKit Cel2 Guide](https://docs.google.com/document/d/1F-9OtZeFOhB7SbgWyUHjOgxBwF-749URZDK0OpgtAqE/edit)
+  
+  </details>
+  
+</details>
+
+<details>
+  <summary>I need help!</summary>
+
+  Reach out to us!
+
+  - Technical question? [celo-org discussions on GitHub](https://github.com/orgs/celo-org/discussions/categories/cel2)
+  - Any type of question? TODO Discord channel
+Forum: 
+
+  Also check out these resources:
+  
+  - [Celo Docs](docs/welcome.md)
+  - [Celo L2 Specifications](https://specs.celo.org/)
+  - [Transaction types on Celo](https://github.com/celo-org/txtypes)
+  - [Celo Forum](https://forum.celo.org/)
+  
+</details>
diff --git a/docs/cel2/faq.md b/docs/cel2/faq.md
index c384188e1d..2bf9c10302 100644
--- a/docs/cel2/faq.md
+++ b/docs/cel2/faq.md
@@ -103,3 +103,7 @@ The gas limit per block is 30 million. The Dango testnet has a throughput of 15M
 - CELO token duality? supported, see [Token Duality](https://specs.celo.org/token_duality.html)
 - fee currencies? supported, see [Fee Abstraction](https://specs.celo.org/fee_abstraction.html)
 - epoch rewards? no longer supported, see [L2 CELO Distribution Schedule](https://specs.celo.org/l2_migration.html#l2-celo-distribution-schedule)
+
+## Not sure what you need to do?
+
+Check out the [decision tree](/docs/cel2/decision-tree.md).
diff --git a/sidebars.js b/sidebars.js
index 07a43762c1..f79d536848 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -1092,6 +1092,11 @@ const sidebars = {
       label: "L1 to L2 Operator Guide",
       id: "cel2/l2-operator-guide",
     },
+    {
+      type: "doc",
+      label: "L1 to L2 Decision Tree",
+      id: "cel2/decision-tree",
+    },
     {
       type: "link",
       label: "Cel2 Dango Bridge",