first iteration content restructuring

OffchainLabs · anegg0 · Nov 12, 2025 · Nov 13, 2025 · Nov 13, 2025 · Nov 13, 2025
commit ff150ec52f1259938fe7a4e661c201eb87e7a74f
diff --git a/docs/stylus/reference/contracts.mdx b/docs/stylus/reference/contracts.mdx
@@ -0,0 +1,22 @@
+---
+title: 'Contracts'
+description: 'Contracts'
+author: chrisco
+sme: chrisco
+sidebar_position: 1
+target_audience: Developers using the Stylus Rust SDK to write and deploy smart contracts.
+displayed_sidebar: buildAppsSidebar
+---
+
+6. Contracts
+   1. Calling other contracts
+      1. Call
+      2. Raw call
+      3. Delegate call
+      4. Static call
+      5. sol_interface
+   2. Sending ETH
+   3. Factory deploy
+   4. Function modifiers
+   5. Inheritance (temporary)
+   6. Constructors (coming soon)
diff --git a/docs/stylus/reference/data-types/compound-types.mdx b/docs/stylus/reference/data-types/compound-types.mdx
@@ -0,0 +1,17 @@
+---
+title: 'Stylus compound types'
+description: 'Stylus Rust SDK compound types'
+author: chrisco
+sme: chrisco
+sidebar_position: 1
+target_audience: Developers using the Stylus Rust SDK to write and deploy smart contracts.
+displayed_sidebar: buildAppsSidebar
+---
+
+2. Compound types
+   1. Tuple
+   2. Struct
+   3. Array
+   4. Vector
+   5. Bytes
+   6. FixedBytes
diff --git a/docs/stylus/reference/data-types/conversions-between-types.mdx b/docs/stylus/reference/data-types/conversions-between-types.mdx
@@ -0,0 +1,11 @@
+---
+title: 'Conversions Between Types'
+description: 'Conversions Between Types'
+author: chrisco
+sme: chrisco
+sidebar_position: 1
+target_audience: Developers using the Stylus Rust SDK to write and deploy smart contracts.
+displayed_sidebar: buildAppsSidebar
+---
+
+TBD
diff --git a/docs/stylus/reference/data-types/primitives.mdx b/docs/stylus/reference/data-types/primitives.mdx
@@ -0,0 +1,15 @@
+---
+title: 'Stylus primitives'
+description: 'Stylus Rust SDK primitives'
+author: chrisco
+sme: chrisco
+sidebar_position: 1
+target_audience: Developers using the Stylus Rust SDK to write and deploy smart contracts.
+displayed_sidebar: buildAppsSidebar
+---
+
+1. Boolean
+2. Integers
+3. Address (include AddressVM traits from types module) 4. String
+   1. Literals
+   2. Hex
diff --git a/docs/stylus/reference/data-types/storage.mdx b/docs/stylus/reference/data-types/storage.mdx
@@ -0,0 +1,20 @@
+---
+title: 'Stylus Rust SDK storage'
+description: 'Stylus Rust SDK storage'
+author: chrisco
+sme: chrisco
+sidebar_position: 1
+target_audience: Developers using the Stylus Rust SDK to write and deploy smart contracts.
+displayed_sidebar: buildAppsSidebar
+---
+
+3. Storage
+   1. Bool
+   2. Uint
+   3. Address
+   4. Struct
+   5. Array
+   6. Map
+   7. String
+   8. Bytes
+   9. FixedBytes
diff --git a/docs/stylus/reference/global-variables-and-functions.mdx b/docs/stylus/reference/global-variables-and-functions.mdx
@@ -0,0 +1,18 @@
+---
+title: 'Global variables and functions'
+description: 'Global variables and functions'
+author: chrisco
+sme: chrisco
+sidebar_position: 1
+target_audience: Developers using the Stylus Rust SDK to write and deploy smart contracts.
+displayed_sidebar: buildAppsSidebar
+---
+
+5. Global variables and functions
+   1. block
+   2. contract
+   3. crypto
+   4. evm
+   5. msg
+   6. tx
+   7. debug
diff --git a/sidebars.js b/sidebars.js
@@ -1215,6 +1215,43 @@ const sidebars = {
               id: 'stylus/reference/project-structure',
               label: 'Structure of a Contract',
             },
+            {
+              type: 'category',
+              label: 'Data types',
+              collapsed: true,
+              items: [
+                {
+                  type: 'doc',
+                  id: 'stylus/reference/data-types/primitives',
+                  label: 'Primitives',
+                },
+                {
+                  type: 'doc',
+                  id: 'stylus/reference/data-types/compound-types',
+                  label: 'Compound types',
+                },
+                {
+                  type: 'doc',
+                  id: 'stylus/reference/data-types/storage',
+                  label: 'Storage',
+                },
+                {
+                  type: 'doc',
+                  id: 'stylus/reference/data-types/conversions-between-types',
+                  label: 'Conversions Between Types',
+                },
+              ],
+            },
+            {
+              type: 'doc',
+              id: 'stylus/reference/global-variables-and-functions',
+              label: 'Global variables and functions',
+            },
+            {
+              type: 'doc',
+              id: 'stylus/reference/contracts',
+              label: 'Contracts',
+            },
             {
               type: 'doc',
               id: 'stylus/how-tos/using-inheritance',