From 174a8030303cb31c0b96336753b351c446b3087b Mon Sep 17 00:00:00 2001
From: mik-tf <logismos@protonmail.ch>
Date: Wed, 30 Oct 2024 11:04:59 -0400
Subject: [PATCH 1/2] updated docs with tokenomics to references

---
 docs_website/docs/introduction.md                | 11 +++++++++++
 docs_website/docs/litepaper.md                   |  2 +-
 docs_website/docs/references/glossary.md         |  2 +-
 docs_website/docs/references/manual.md           |  8 ++++++--
 docs_website/docs/{ => references}/tokenomics.md |  2 +-
 5 files changed, 20 insertions(+), 5 deletions(-)
 create mode 100644 docs_website/docs/introduction.md
 rename docs_website/docs/{ => references}/tokenomics.md (99%)

diff --git a/docs_website/docs/introduction.md b/docs_website/docs/introduction.md
new file mode 100644
index 0000000..baecd6f
--- /dev/null
+++ b/docs_website/docs/introduction.md
@@ -0,0 +1,11 @@
+---
+sidebar_position: 1
+---
+
+# Introduction
+
+ThreeFold is a decentralized platform for unbreakable data, peer-to-peer network, and autonomous cloud. Founded by a core team with deep roots in the early Internet, they bring first-hand experience from its origins as a decentralized network to its evolution into today’s centralized systems.
+
+Over the years, the team developed core technological components for a decentralized cloud, a data storage system which cannot fail, and an end-to-end network system – all from the ground up. Subsequently, a global community of independent people and organizations expanded the network as proof that a decentralized open-source Internet can be revived. 
+
+Now, the project is entering its next phase, ThreeFold V4. This phase is focused on commercial expansion, broader adoption, and completing the remaining components needed to form a cohesive and complete alternative to today’s centralized systems. 
\ No newline at end of file
diff --git a/docs_website/docs/litepaper.md b/docs_website/docs/litepaper.md
index b20c058..fc002c9 100644
--- a/docs_website/docs/litepaper.md
+++ b/docs_website/docs/litepaper.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 2
 ---
 
 # Litepaper
diff --git a/docs_website/docs/references/glossary.md b/docs_website/docs/references/glossary.md
index 8e1ab08..3b5a71d 100644
--- a/docs_website/docs/references/glossary.md
+++ b/docs_website/docs/references/glossary.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 2
+sidebar_position: 1
 ---
 
 # Glossary
diff --git a/docs_website/docs/references/manual.md b/docs_website/docs/references/manual.md
index d06275d..6fa49be 100644
--- a/docs_website/docs/references/manual.md
+++ b/docs_website/docs/references/manual.md
@@ -1,5 +1,9 @@
+---
+sidebar_position: 2
+---
+
 # Manual
 
-The ThreeFold Docs website provide basic information on ThreeFold. 
+The ThreeFold Docs website you are currently reading provide essential information on ThreeFold V4.
 
-If you want to read advanced documentation, you can visit the [***ThreeFold Manual website***](https://manual.grid.tf/). This manual contains in-depth informations for ThreeFold Farmers, Sysadmins and Developers.
\ No newline at end of file
+If you want to read advanced documentation concerning ThreeFold V3, you can visit the [***ThreeFold V3 Manual website***](https://manual.grid.tf/). This manual contains in-depth informations for ThreeFold Farmers, Sysadmins and Developers using the V3 iteration of the ThreeFold Grid.
\ No newline at end of file
diff --git a/docs_website/docs/tokenomics.md b/docs_website/docs/references/tokenomics.md
similarity index 99%
rename from docs_website/docs/tokenomics.md
rename to docs_website/docs/references/tokenomics.md
index 73404dd..d4afc20 100644
--- a/docs_website/docs/tokenomics.md
+++ b/docs_website/docs/references/tokenomics.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 2
+sidebar_position: 3
 ---
 
 # Tokenomics

From 67e397a1fbabab4f1d980dbb9c52c2a4b525e344 Mon Sep 17 00:00:00 2001
From: mik-tf <logismos@protonmail.ch>
Date: Wed, 30 Oct 2024 12:08:35 -0400
Subject: [PATCH 2/2] updated docs with roadmap, phones

---
 docs_website/docs/legal/_category_.json       |  2 +-
 .../docs/{guides => nodes}/_category_.json    |  4 +--
 .../{guides => nodes}/connect_the_nodes.md    |  0
 .../docs/{guides => nodes}/create_farm.md     |  0
 .../docs/{guides => nodes}/get_nodes.md       |  0
 .../docs/{guides => nodes}/manage_rewards.md  |  0
 .../{guides => nodes}/threefold_connect.md    |  0
 docs_website/docs/phones/_category_.json      |  8 +++++
 docs_website/docs/phones/get_ourphone.md      |  9 ++++++
 docs_website/docs/phones/ourphone_features.md | 25 +++++++++++++++
 docs_website/docs/references/_category_.json  |  2 +-
 docs_website/docs/references/manual.md        |  2 +-
 docs_website/docs/references/tokenomics.md    |  2 +-
 docs_website/docs/roadmap.md                  | 32 +++++++++++++++++++
 docs_website/docusaurus.config.ts             | 27 ++++++++++------
 docs_website/src/pages/index.tsx              |  2 +-
 16 files changed, 99 insertions(+), 16 deletions(-)
 rename docs_website/docs/{guides => nodes}/_category_.json (72%)
 rename docs_website/docs/{guides => nodes}/connect_the_nodes.md (100%)
 rename docs_website/docs/{guides => nodes}/create_farm.md (100%)
 rename docs_website/docs/{guides => nodes}/get_nodes.md (100%)
 rename docs_website/docs/{guides => nodes}/manage_rewards.md (100%)
 rename docs_website/docs/{guides => nodes}/threefold_connect.md (100%)
 create mode 100644 docs_website/docs/phones/_category_.json
 create mode 100644 docs_website/docs/phones/get_ourphone.md
 create mode 100644 docs_website/docs/phones/ourphone_features.md
 create mode 100644 docs_website/docs/roadmap.md

diff --git a/docs_website/docs/legal/_category_.json b/docs_website/docs/legal/_category_.json
index 0b85642..953ec94 100644
--- a/docs_website/docs/legal/_category_.json
+++ b/docs_website/docs/legal/_category_.json
@@ -1,6 +1,6 @@
 {
     "label": "Legal",
-    "position": 5,
+    "position": 7,
     "link": {
       "type": "generated-index",
     }
diff --git a/docs_website/docs/guides/_category_.json b/docs_website/docs/nodes/_category_.json
similarity index 72%
rename from docs_website/docs/guides/_category_.json
rename to docs_website/docs/nodes/_category_.json
index 7ad478f..72f9db1 100644
--- a/docs_website/docs/guides/_category_.json
+++ b/docs_website/docs/nodes/_category_.json
@@ -1,6 +1,6 @@
 {
-    "label": "Node Guides",
-    "position": 3,
+    "label": "Nodes",
+    "position": 5,
     "link": {
       "type": "generated-index",
       "description": "Learn how to host ThreeFold nodes and earn rewards."
diff --git a/docs_website/docs/guides/connect_the_nodes.md b/docs_website/docs/nodes/connect_the_nodes.md
similarity index 100%
rename from docs_website/docs/guides/connect_the_nodes.md
rename to docs_website/docs/nodes/connect_the_nodes.md
diff --git a/docs_website/docs/guides/create_farm.md b/docs_website/docs/nodes/create_farm.md
similarity index 100%
rename from docs_website/docs/guides/create_farm.md
rename to docs_website/docs/nodes/create_farm.md
diff --git a/docs_website/docs/guides/get_nodes.md b/docs_website/docs/nodes/get_nodes.md
similarity index 100%
rename from docs_website/docs/guides/get_nodes.md
rename to docs_website/docs/nodes/get_nodes.md
diff --git a/docs_website/docs/guides/manage_rewards.md b/docs_website/docs/nodes/manage_rewards.md
similarity index 100%
rename from docs_website/docs/guides/manage_rewards.md
rename to docs_website/docs/nodes/manage_rewards.md
diff --git a/docs_website/docs/guides/threefold_connect.md b/docs_website/docs/nodes/threefold_connect.md
similarity index 100%
rename from docs_website/docs/guides/threefold_connect.md
rename to docs_website/docs/nodes/threefold_connect.md
diff --git a/docs_website/docs/phones/_category_.json b/docs_website/docs/phones/_category_.json
new file mode 100644
index 0000000..ceac352
--- /dev/null
+++ b/docs_website/docs/phones/_category_.json
@@ -0,0 +1,8 @@
+{
+    "label": "Phones",
+    "position": 4,
+    "link": {
+      "type": "generated-index",
+      "description": "OurPhone is the first truly decentralized smartphone."
+    }
+  }
\ No newline at end of file
diff --git a/docs_website/docs/phones/get_ourphone.md b/docs_website/docs/phones/get_ourphone.md
new file mode 100644
index 0000000..ebfe3de
--- /dev/null
+++ b/docs_website/docs/phones/get_ourphone.md
@@ -0,0 +1,9 @@
+---
+title: Get OurPhone
+description: How to Get ThreeFold Phones
+sidebar_position: 2
+---
+
+There are different models of ThreeFold OurPhones available. Your ThreeFold OurPhone represents your private and secure gateway to the online world.
+
+Visit the [***official OurPhone website***](https://ourphone.tf/) to buy ThreeFold phones.
\ No newline at end of file
diff --git a/docs_website/docs/phones/ourphone_features.md b/docs_website/docs/phones/ourphone_features.md
new file mode 100644
index 0000000..d6685d4
--- /dev/null
+++ b/docs_website/docs/phones/ourphone_features.md
@@ -0,0 +1,25 @@
+---
+title: Features
+description: The Decentralized Smartphone
+sidebar_position: 1
+---
+
+The ThreeFold OurPhones presents unique features that makes it the ultimate decentralized smartphone on the market.
+
+- **100% Data Ownership**
+  - With OurPhone™, you are the sole owner of your data, will always be, not some giant tech companies.
+
+- **Quantum Safe Storage**
+  - Enjoy decentralized cloud storage benefit that comes with every OurPhone™ Apps subscription.
+
+- **Introducing OurVerse™**
+  - OurApps™: decentralized SuperApps powered by OurPhone™ are ready to meet our needs.
+
+- **Decentralized Network Support**
+  - OurVerse™ are hosted on the world's largest decentralized network. Join the movement.
+
+- **Edge Computing Speed**
+  - Experience unparalleled usage speed with OurVerse™'s latest edge cloud technology.
+
+- **Fully Encrypted Communication**
+  - Any transfer of data is powered by Planetary Network™, a fully encrypted network technology.
\ No newline at end of file
diff --git a/docs_website/docs/references/_category_.json b/docs_website/docs/references/_category_.json
index 98f73ba..e5110c0 100644
--- a/docs_website/docs/references/_category_.json
+++ b/docs_website/docs/references/_category_.json
@@ -1,6 +1,6 @@
 {
     "label": "References",
-    "position": 4,
+    "position": 6,
     "link": {
       "type": "generated-index"
     }
diff --git a/docs_website/docs/references/manual.md b/docs_website/docs/references/manual.md
index 6fa49be..82bdc15 100644
--- a/docs_website/docs/references/manual.md
+++ b/docs_website/docs/references/manual.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 2
+sidebar_position: 3
 ---
 
 # Manual
diff --git a/docs_website/docs/references/tokenomics.md b/docs_website/docs/references/tokenomics.md
index d4afc20..73404dd 100644
--- a/docs_website/docs/references/tokenomics.md
+++ b/docs_website/docs/references/tokenomics.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 3
+sidebar_position: 2
 ---
 
 # Tokenomics
diff --git a/docs_website/docs/roadmap.md b/docs_website/docs/roadmap.md
new file mode 100644
index 0000000..e46011f
--- /dev/null
+++ b/docs_website/docs/roadmap.md
@@ -0,0 +1,32 @@
+---
+sidebar_position: 3
+---
+
+# Roadmap
+
+ThreeFold built a self-healing data, network and cloud platform. This platform is a complete and cohesive system providing a viable and efficient alternative to current mainstream clouds. The whole is bigger than the sum of its parts with this project, as all components interact together to form a cohesive and complete data, network and cloud platform.
+
+Feel free to read the [Litepaper](./litepaper.md) to know more about the complete ThreeFold platform and its many components.
+
+The following presents the current state of the grid and what is to come.
+
+## Launched
+
+- [x] ThreeFold Decentralized Cloud
+- [x] ThreeFold Nodes
+- [x] Data Storage System which cannot fail
+- [x] Mycelium Global end-to-end shortest path network system
+- [x] Mycelium Web2 Gateway
+- [x] Mycelium Message Bus
+
+## Upcoming
+
+- [ ] ThreeFold Phone
+- [ ] ThreeFold Magic Cloud Node Cluster
+- [ ] Mycelium Naming Services
+- [ ] Mycelium Wifi Integration
+- [ ] Mycelium Video Conferencing 
+- [ ] Mycelium Chat
+- [ ] Mycelium CDN
+- [ ] Mycelium VPN
+- [ ] Mycelium Web3 Gateway
\ No newline at end of file
diff --git a/docs_website/docusaurus.config.ts b/docs_website/docusaurus.config.ts
index c118d32..ca6a267 100644
--- a/docs_website/docusaurus.config.ts
+++ b/docs_website/docusaurus.config.ts
@@ -130,12 +130,8 @@ const config: Config = {
               to: '/docs/litepaper',
             },
             {
-              label: 'Tokenomics',
-              to: '/docs/tokenomics',
-            },
-            {
-              label: 'Node Guides',
-              to: '/docs/category/node-guides',
+              label: 'Roadmap',
+              to: '/docs/roadmap',
             },
             {
               label: 'References',
@@ -148,12 +144,21 @@ const config: Config = {
           ],
         },
         {
-          title: 'Community',
+          title: 'Products',
           items: [
             {
-              label: 'Forum',
-              href: 'https://forum.threefold.io',
+              label: 'Phones',
+              to: '/docs/category/phones',
             },
+            {
+              label: 'Nodes',
+              to: '/docs/category/nodes',
+            },
+          ],
+        },
+        {
+          title: 'Community',
+          items: [
             {
               label: 'Telegram',
               href: 'https://t.me/threefold',
@@ -162,6 +167,10 @@ const config: Config = {
               label: 'X',
               href: 'https://x.com/threefold_io',
             },
+            {
+              label: 'Forum',
+              href: 'https://forum.threefold.io',
+            },
             {
               label: 'Support',
               to: '/support',
diff --git a/docs_website/src/pages/index.tsx b/docs_website/src/pages/index.tsx
index 6da0e2d..b2b13e4 100644
--- a/docs_website/src/pages/index.tsx
+++ b/docs_website/src/pages/index.tsx
@@ -19,7 +19,7 @@ function HomepageHeader() {
         <div className={styles.buttons}>
           <Link
             className="button button--secondary button--lg"
-            to="/docs/litepaper">
+            to="/docs/introduction">
             Explore the ThreeFold Grid
           </Link>
         </div>