Urgent Update to the Learn Section

.yarnrc.yml

@@ -0,0 +1,3 @@
+nodeLinker: node-modules
+
+yarnPath: .yarn/releases/yarn-classic.cjs

docs/build/integrations/_category_.json

@@ -1,4 +1,4 @@
 {
     "label": "Integrations",
-    "position": 9
+    "position": 6
 }

docs/build/nodes/_category_.json

@@ -1,4 +1,4 @@
 {
   "label": "Run A Node",
-  "position": 9
+  "position": 7
 }

docs/build/soneium/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "Soneium",
+    "position": 8
+}

docs/build/soneium/index.md

@@ -0,0 +1 @@
+# Soneium

docs/getting-started.md

@@ -1,23 +1,36 @@
 ---
 sidebar_position: 1
+sidebar_label: Getting Started
+tags:
+    - astar
+    - intro
+    - devs
+description: Getting started section of the docs
 ---
 
 # Getting Started
 
-Astar is an interoperable blockchain platform for Polkadot and Ethereum ecosystems supporting both Wasm and EVM smart contracts. Astar provides native access to Polkadot and Ethereum through its parachain slot and Layer 2 scaling solution, while also offering bridges into other major blockchain ecosystems. Through the #Build2Earn program, Astar offers a basic income to dApp developers, and direct funding to projects through an *unstoppable grants* program.
+## Introduction
+
+**Astar Network** is an interoperable blockchain platform for [**Polkadot**](https://polkadot.com/) and [**Ethereum**](https://ethereum.org/en/) ecosystems supporting both Wasm and EVM smart contracts. Astar provides native access to Polkadot and Ethereum through its parachain slot and its direct integration with [**Soneium**](https://soneium.org/en/), while also offering bridges into other major blockchain ecosystems. Through the **#Build2Earn program**, *Astar Network* offers a basic income to dApp developers and funding to projects through an **unstoppable grants** program.
 
 ## Overview of Docs
 
-- [**Build**](/docs/build) - Provides the resources you need to start building, testing, deploying, and interacting with smart contracts on Astar network.
-- [**EVM**](/docs/build/EVM) - Dives deeper into the EVM on Astar and explains how EVM smart contracts can interact with non-EVM modules and the Wasm virtual machine through [precompiles](https://docs.astar.network/docs/build/EVM/precompiles/).
-- [**Wasm**](/docs/build/wasm) - Provides an overview of the [Wasm stack](https://docs.astar.network/docs/build/wasm/smart-contract-wasm) on Astar, [Wasm contract frameworks](/docs/build/wasm/dsls), and [Swanky Suite](/docs/build/wasm/swanky-suite/).
-- [**dApp Staking**](/docs/learn/dapp-staking/) - Earn tokens for yourself and your dApp by staking tokens and registering your dApp with Astar’s dApp Staking.
-- [**zkEVM**](/docs/build/zkEVM) - Contains everything developers need to know to start building on Astar's Layer 2 scaling solution for Ethereum.
-- [**Nodes**](/docs/build/nodes) - Explains how to run full nodes, collators, indexers, and everything else related to infrastructure.
-- [**XCM**](/docs/learn/interoperability/xcm) - Explains how XCM is used in Astar and also how developers can use it to interact with the rest of the Polkadot network.
-- [**Integrations**](/docs/build/integrations/) - Provides relevant information about the wallets, indexers, and oracles that are integrated with the network.
-- [**Docs Integration Request**](https://github.com/AstarNetwork/astar-docs/blob/main/docs-integration-request.md) - Provides information about how to make a documentation integration request for this repository.
+- [**Build**](/docs/build) → Provides the resources you need to start building, testing, deploying, and interacting with smart contracts on Astar Collective.
+- [**EVM**](/docs/build/EVM) → Dives deeper into the EVM on Astar Network and explains how EVM smart contracts can interact with non-EVM modules and the Wasm virtual machine through [precompiles](https://docs.astar.network/docs/build/EVM/precompiles/).
+- [**Wasm**](/docs/build/wasm) → Provides an overview of the [Wasm stack](https://docs.astar.network/docs/build/wasm/smart-contract-wasm) on Astar Network, [Wasm contract frameworks](/docs/build/wasm/dsls), and [Swanky Suite](/docs/build/wasm/swanky-suite/).
+- [**dApp Staking**](/docs/learn/dapp-staking/) → Earn tokens for yourself and your dApp by staking tokens and registering your dApp with Astar’s dApp Staking.
+- [**Soneium**](/docs/build/soneium) → Contains everything developers need to know to start building on Soneium, an Ethereum Optimistic Rollup connected to the Superchain Ecosystem.
+- [**Nodes**](/docs/build/nodes) → Explains how to run full nodes, collators, indexers, and everything else related to infrastructure.
+- [**XCM**](/docs/learn/interoperability/xcm) → Explains how XCM is used in Astar Network and also how developers can use it to interact with the rest of the Polkadot network.
+- [**Integrations**](/docs/build/integrations/) → Provides relevant information about the wallets, indexers, and oracles that are integrated with the Astar Collective.
+- [**Docs Integration Request**](https://github.com/AstarNetwork/astar-docs/blob/main/docs-integration-request.md) → Provides information about how to make a documentation integration request for this repository.
+- [**Tutorials**](/docs/tutorials/index.md) → It contains a series of written technical guides and step-by-step video tutorials on how to implement and use the tools provided by Astar Collective and third parties.
 
 ## Audit Reports
 
-A comprehensive list of finalized audit reports of Astar Network's codebase is available on GitHub - [Astar Network Audit Reports](https://github.com/AstarNetwork/Audits)
+:::info[Audits]
+
+A comprehensive list of finalized audit reports of Astar Network's codebase is available on GitHub. You can check them here → [**Astar Network Audit Reports**](https://github.com/AstarNetwork/Audits).
+
+:::

docs/learn/_category_.json

@@ -1,4 +1,4 @@
 {
     "label": "Learn",
-    "position": 1
-}
+    "position": 2
+}

docs/learn/accounts.md

@@ -1,32 +1,64 @@
 ---
 sidebar_position: 2
+sidebar_label: Accounts
+tags:
+    - astar
+    - intro
+    - devs
+description: Astar accounts
 ---
+
 # Accounts
-## Overview
 
-An account on Astar Network consists of two parts - a private key and a public key. A public key is also known as an address of an account because it is accessible and known to the public - just like an e-mail address, for example. A private key is a key to access and manage your address. With that said, anybody can send tokens to your address, but only you can access them with your private key. Therefore, it is crucial to keep your private keys safe at all times. 
+## Introduction
+
+An account on Astar Network consists of two parts - a **private key** and a **public key**. A public key is also known as an address of an account because it is accessible and known to the public - just like an e-mail address, for example. A private key is a key to access and manage your address. With that said, anybody can send tokens to your address, but only you can access them with your private key. Therefore, it is crucial to keep your private keys safe at all times and with security backups.
+
+:::info[Astar Network accounts]
+
+Astar Network supports two virtual machines (Wasm VM and EVM) and therefore utilizes two account formats: ss58 y H160.
 
-Astar Network supports two virtual machines (Wasm VM and EVM) and therefore utilizes two account formats. 
+:::
 
 ## Substrate Accounts
 
-Astar is built with Substrate, a framework to build blockchains, and uses Substrate accounts. Substrate-based chains use the underlying public key to derive one or more public addresses. Instead of using the public key directly, Substrate allows you generate multiple addresses and address formats for an account, meaning you only need to generate your public key, private key pair once and derive different addresses for different Substrate-chains. 
+Astar Network is built with [**Substrate**](https://docs.polkadot.com/develop/parachains/intro-polkadot-sdk/#substrate), a framework to build blockchains, and uses Substrate accounts. Substrate-based chains use the underlying public key to derive one or more public addresses. Instead of using the public key directly, Substrate allows you generate multiple addresses and address formats for an account, meaning you only need to generate your public key, private key pair once and derive different addresses for different Substrate-chains. Right now **Polkadot** uses Substrate in its core.
+
+:::info[Info about Substrate]
+
+The Parity Technologies team has merged the Substrate repository and all its information with the Polkadot SDK. Now, if you want to access information about Substrate, you must do so through the → [**Polkadot website**](https://polkadot.com/platform/sdk).
+
+:::
 
 The private key is a cryptographically-secure sequence of randomly-generated numbers. For human readability, the private key generates a random sequence of words called a secret seed phrase or mnemonic.
 
-The address format used in Substrate-based chains like Astar is ss58. ss58 is a modification of Base-58-check from Bitcoin, with some minor modifications. Notably, the format contains an address type prefix that identifies an address as belonging to a specific network.
+The address format used in Substrate-based chains like Astar is **ss58**. ss58 is a modification of **Base-58-check** from Bitcoin, with some minor modifications. Notably, the format contains an address type prefix that identifies an address as belonging to a specific network.
 
-Astar supports specialized accounts, such as Proxy and Keyless accounts. 
-You can read more about Proxy accounts [here](/docs/learn/Proxies).
+:::tip[Learn more]
+
+Dive deeper into the topic with this guide → [**Substrate Address Format**](https://wiki.polkadot.network/docs/learn-account-advanced#:~:text=The%20address%20format%20used%20in,format%20is%20the%20MultiAddress%20type.).
+
+:::
+
+> Astar Network supports specialized accounts, such as *Proxy* and *Keyless* accounts. 
+You can read more about **Proxy** accounts → [here](/docs/learn/Proxies).
 
 ## EVM Accounts
 
-Astar EVM side allows Ethereum-style addresses (H160 format), which is 40+2 hex-characters long, in a Substrate based chain. This address matches a private key, which can be used to sign transactions in the Ethereum side of the chain. Furthermore, the address is mapped into a storage slot inside the Substrate Balance pallet to a Substrate-style address (H256 format).
+*Astar EVM* side allows Ethereum-style addresses (**H160 format**), which is 40+2 hex-characters long, in a *Substrate based* chain. This address matches a private key, which can be used to sign transactions in the Ethereum side of the chain. Furthermore, the address is mapped into a storage slot inside the Substrate Balance pallet to a Substrate-style address (**H256 format**).
 
+:::tip[Learn more]
 
-## Learn more
-[Create a Substrate account](/docs/use/manage-wallets/create-wallet/)
+Dive deeper into the topic with this guide → [**EVM Accounts**](https://ethereum.org/en/developers/docs/accounts/).
+
+:::
 
-[Create an EVM account](/docs/use/evm-guides/setup-metamask/)
+import DocCardList from '@theme/DocCardList';
 
-[Read about Substrate accounts](https://docs.substrate.io/learn/accounts-addresses-keys/)
+## Learn more
+<DocCardList items={[
+    { type: 'link', label: 'Create a Substrate account', href: '/docs/use/manage-wallets/create-wallet/' },
+    { type: 'link', label: 'Create an EVM account', href: '/docs/use/evm-guides/setup-metamask/' },
+    { type: 'link', label: 'Read Substrate accounts', href: 'https://docs.substrate.io/learn/accounts-addresses-keys' },
+    { type: 'link', label: 'Create a Proxy account', href: '/docs/use/manage-wallets/pallet-proxy/' },
+]} />

docs/learn/architecture/_category_.json

@@ -1,4 +1,4 @@
 {
-    "label": "Architecture",
+    "label": "Astar Architecture",
     "position": 7
-}
+}

docs/learn/architecture/astar-zkevm.md

@@ -1,6 +1,6 @@
 ---
 title: Astar zkEVM
-sidebar_position: 2
+sidebar_position: 3
 ---
 
 # Overview

docs/learn/architecture/index.md

@@ -1,29 +1,54 @@
 ---
-title: Architecture
+tags:
+    - astar
+    - devs
+    - intro
+    - soneium
+    - users
+description: Astar Collective global architecture
 ---
 
 import Figure from '/src/components/figure'
 
-# Overview
-Before you get started on your journey towards becoming an Astar network hacker, it will be beneficial to know about what Polkadot and Ethereum are, because Astar Network connects to both, and each have their own set of benefits benefits and limitations.
+# Astar Collective Architecture
 
-<Figure src={require('/docs/learn/architecture/img/fig4.jpg').default} />
+## Introduction
+
+Before you get started on your journey towards becoming an **Astar Collective hacker**, it will be beneficial to know about what **Polkadot** and **Ethereum** are, because Astar Collective connects to both, and each have their own set of benefits and limitations.
+
+<Figure caption="Astar Collective Architecture" src={require('/docs/learn/architecture/img/fig4.jpg').default } width="100%" /> 
+
+:::info[Polkadot & Ethereum]
 
 Some highlights on the Polkadot parachain side are dApp Staking, ink! smart contracts, cross-chain messaging (XCM), and forkless upgradability, and on the Ethereum layer 2 side are the highest levels of EVM equivalence, shared liquidity across layer 2 networks, and access to the largest pool of developers in the blockchain industry that we can tailor our products for, on-demand.
 
-For now, let's go over some basics that apply to all blockchains whether they are sovereign layer 1 networks, or rely on another blockchain such as the Polkadot Relay Chain for shared security and interoperability. 
+:::
+
+For now, let's go over some basics that apply to all blockchains whether they are sovereign layer 1 networks, or rely on another blockchain such as the **Polkadot Relay Chain** for shared security and interoperability. 
 
 ## Blockchain Basics
-A blockchain is a decentralized ledger that records information in a sequence of blocks. The information contained in a block is an ordered set of instructions that may or may not result in a change in state.
+A blockchain is a decentralized **ledger** that records information in a sequence of **blocks**. The information contained in a block is an ordered set of instructions that may or may not result in a change in state.
+
+In a blockchain network, individual computers—called **nodes**—communicate with each other to form a decentralized **peer-to-peer** (P2P) network. There is no central authority that controls the network and, typically, each node that participates in block production stores a copy of the blocks that make up the **canonical chain**.
 
-In a blockchain network, individual computers—called nodes—communicate with each other to form a decentralized peer-to-peer (P2P) network. There is no central authority that controls the network and, typically, each node that participates in block production stores a copy of the blocks that make up the canonical chain.
+In most cases, users interact with a blockchain by submitting a request that might result in a change in state, for example, a request to change the owner of a file or to transfer funds from one account to another. These transactions requests are gossiped to other nodes on the network and assembled into a block by a block author. To ensure the security of the data on the chain and the ongoing progress of the chain, the nodes use some form of consensus to agree on the state of the data in each block and on the order of transactions executed. 
 
-In most cases, users interact with a blockchain by submitting a request that might result in a change in state, for example, a request to change the owner of a file or to transfer funds from one account to another. These transactions requests are gossiped to other nodes on the network and assembled into a block by a block author. To ensure the security of the data on the chain and the ongoing progress of the chain, the nodes use some form of consensus to agree on the state of the data in each block and on the order of transactions executed. [Read more...](https://docs.substrate.io/fundamentals/blockchain-basics/)
+:::tip[Learn more]
+
+Read more about blockchain basics → [**here**](https://docs.substrate.io/fundamentals/blockchain-basics/).
+
+:::
 
 ## Applications Running on a Blockchain
-Applications that run on a blockchain, often referred to as decentralized applications or dApps, are typically web applications written using front-end frameworks, but powered by smart contracts on the backend, to affect the blockchain state.
+Applications that run on a **blockchain**, often referred to as decentralized applications or **dApps**, are typically web applications written using **front-end frameworks**, but powered by smart contracts on the **backend**, to affect the blockchain state.
 
 A **smart contract** is a program that runs on a blockchain and executes transactions on behalf of users under specific conditions. Developers can write smart contracts to ensure that the outcomes of programmatically-executed transactions are recorded, and can't be tampered with. Yet, smart contracts operate in a sandboxed environment, where developers don't have access to underlying blockchain functionality, such as  consensus, storage, or transaction layers, and instead, abide by a chain's fixed rules and restrictions. Smart contract developers often accept these limitations as a tradeoff that shortens the development lifecycle, by avoiding having to make core design decisions.
 
 ## Ethereum Virtual Machine (EVM)
-The Ethereum Virtual Machine (EVM) is a virtual computer with components that enables  network participants (not necessarily on Ethereum) to store data and agree on the state of that data. Smart contracts run on the EVM, and most Layer 1 blockchains support an EVM-compatible virtual machine environment. Astar Parachain and Astar zkEVM both support EVM-compatible environments.
+The **Ethereum Virtual Machine** (EVM) is a virtual computer with components that enables  network participants (not necessarily on Ethereum) to store data and agree on the state of that data. **Smart contracts** run on the EVM, and most Layer 1 blockchains support an **EVM-compatible** virtual machine environment. 
+
+:::info[EVM in Astar Collective]
+
+[**Astar Parachain**](/docs/learn/architecture/astar-parachain.md) and [**Soneium**](/docs/learn/architecture/soneium.md) both support EVM-compatible environments.
+
+:::

docs/learn/architecture/soneium.md

@@ -0,0 +1,6 @@
+---
+title: Soneium
+sidebar_position: 2
+---
+
+# Overview