fix new broken links

docs/about/architecture/astar-parachain.md

@@ -48,10 +48,10 @@ Read more about [Runtime development](https://docs.substrate.io/fundamentals/run
 The Polkadot runtime does not support smart contracts. Smart contracts require a Virtual Machine (VM) environment where contracts can be executed, and the most well-known and widely supported platform being the Ethereum Virtual Machine (EVM). Substrate FRAME contains modules that support Wasm smart contract execution, as well as EVM.
 
 ### Ethereum Virtual Machine (EVM)
-The Ethereum Virtual Machine (EVM) is a virtual computer with components that enable Ethereum network participants to store data and agree on the state of that data. On a Substrate-based blockchain, the core responsibilities of the EVM are implemented in the EVM pallet, that's responsible for executing Ethereum contract bytecode written in a high level language like Solidity. Astar EVM provides a fully Ethereum Virtual Machine compatible platform, which you can learn more about in the [EVM chapter](/docs/build/evm). 
+The Ethereum Virtual Machine (EVM) is a virtual computer with components that enable Ethereum network participants to store data and agree on the state of that data. On a Substrate-based blockchain, the core responsibilities of the EVM are implemented in the EVM pallet, that's responsible for executing Ethereum contract bytecode written in a high level language like Solidity. Astar EVM provides a fully Ethereum Virtual Machine compatible platform, which you can learn more about in the [EVM chapter](/docs/build/build-on-layer-1/smart-contracts/EVM/index.md)
 
 ### Substrate Virtual Machine for Wasm Contracts
-Substrate also ships with a module for smart contracts, called `pallet-contracts`. If a parachain is developed on Substrate it can easily add smart contract functionality by including this pallet. Astar supports this Polkadot Native approach to smart contracts, and you can learn more in the [Wasm chapter](/docs/build/wasm). 
+Substrate also ships with a module for smart contracts, called `pallet-contracts`. If a parachain is developed on Substrate it can easily add smart contract functionality by including this pallet. Astar supports this Polkadot Native approach to smart contracts, and you can learn more in the [Wasm chapter](/docs/build/build-on-layer-1/smart-contracts/wasm/index.md). 
 
 
 

docs/about/architecture/index.md

@@ -26,4 +26,4 @@ Applications that run on a blockchain, often referred to as decentralized applic
 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. Astar Parachain and Astar zkEVM both support EVM-compatible environments.

docs/about/economics/tokenomics2-network-fees.md

@@ -51,7 +51,7 @@ $$
 - $weight\_fee$ - is the fee related to the weight of the transaction.
 - $c$ - fee multiplier; if network utilization is above ideal, `c` factor will increase, forcing users to pay more. And vice-versa, when network congestion is low, fee multiplier will decrease.
 - $length\_fee$ - this is part of the fee related to the transaction length (number of bytes).
-- $rent\_fee$ - deposit fee for storing data on chain. Detailed explanation of rent fee calculation in case of Wasm transactions can be found under the [in the Build section](/docs/build/wasm/transaction-fees#storage-rent).
+- $rent\_fee$ - deposit fee for storing data on chain. Detailed explanation of rent fee calculation in case of Wasm transactions can be found under the [in the Build section](/docs/build/build-on-layer-1/smart-contracts/wasm/transaction-fees.md#storage-rent).
 - $tip$ - extra payment transaction submitter pays to ensure their transaction gets included faster into a block.
 
 Native fees are inherently dynamic using the fee multiplies `c` which is calculated in each block using the following formulas:

docs/about/networks.md

@@ -5,23 +5,23 @@ sidebar_position: 6
 # Networks
 ## Overview
 
-Prior to commencing development it's important to understand the Astar Network family, and choose an appropriate network based on what you would like to do. Currently, there are a number of networks available, including the Local network which runs exclusively within your development environment. All networks support EVM RPCs, and Astar Parachain supports Substrate RPC as well.
+Prior to commencing development it's important to understand the Astar Network family, and choose an appropriate network to deploy on based on what you would like to do. Currently, there are a number of networks available, including the Local network which runs exclusively within your development environment. All networks support EVM RPCs, and Astar Parachain supports Substrate RPC as well.
 
 ![Astar networks](../about/products/img/fig4.jpg)
 
 ## Local Networks
 
 ### Substrate Node
-You can clone the Astar repository and run the local node provided, or download the precompiled binary and run it, instead. Both methods are described in the [Build](/docs/build) section.
+You can clone the Astar repository and run the local node provided, or download the precompiled binary and run it, instead. Both methods are described in the [Nodes](/docs/build/build-on-layer-1/nodes/index.md) section.
 
 ### Swanky Node
 
 Swanky Node is a Substrate based blockchain configured to enable the smart contract module `pallet-contracts`, and other features that assist local development of Wasm smart contracts.
-For more information about Swanky Node, check out the [Swanky Suite](https://docs.astar.network/docs/build/wasm/swanky-suite/) section. [INSERT LINK]
+For more information about Swanky Node, check out the [Swanky Suite](https://docs.astar.network/docs/build/build-on-layer-1/smart-contracts/wasm/swanky-suite/) section. [INSERT PROPER LINK]
 
 ### Zombienet
 
-With Zombienet users can download arbitrary Relay Chain and parachain binaries (or use images) to setup a configurable local test network. Users will have access to all privileged actions on the Relay Chain and parachains, which simplifies testing. For more information about Zombienet, check out the [Build Environment](https://docs.astar.network/docs/build/environment/zombienet-testing) chapter. [INSERT LINK]
+With Zombienet users can download arbitrary Relay Chain and parachain binaries (or use images) to setup a configurable local test network. Users will have access to all privileged actions on the Relay Chain and parachains, which simplifies testing. For more information about Zombienet, check out the [Build Environment](https://docs.astar.network/docs/build/environment/zombienet-testing) chapter. [INSERT PROPER LINK]
 
 ## Testnets
 
@@ -34,10 +34,6 @@ The Shibuya native token symbol is SBY.
 
 To obtain test tokens from the faucet, please visit the Astar Portal and connect to Shibuya. If for any reason the faucet is empty, please contact the Astar team on Discord.
 
-### zKyoto (Sepolia)
-
-zKyoto is a Validium-based network connected to the Ethereum Sepolia testnet and Polygon AggLayer. It is the testing and proving ground for dApps deployed on the Astar zkEVM.
-
 ## Mainnets
 
 Astar has three mainnets. One parachain on Kusama, One parachain on Polkadot, and a zkEVM-based network on Ethereum Layer 2.
@@ -54,7 +50,4 @@ By now you may have guessed that Astar parachain is connected to Polkadot Relay
 
 The Astar native token symbol is ASTR.
 
-### Astar zkEVM
-
-Astar zkEVM is a Layer 2 scaling solution for Ethereum, powered by Polygon AggLayer. Technically referred to as a Validium, the zkEVM combines zk rollups with modular data availability, synthesizing the best features of each.
 

docs/about/products/dapp-staking/dapp-staking-faq.md

@@ -19,8 +19,8 @@ These are major remarks about the migration:
 
 If any of the terms above are unclear to you (e.g. _staking_ vs _locking_) you can find detailed exaplanation the following sections:
 
-- [Tokenomics 2.0](/docs/learn/tokenomics2/)
-- [dApp Staking V3 Technical Overview](/docs/learn/dapp-staking/dapp-staking-protocol/)
+- [Tokenomics 2.0](/docs/about/economics/index.md)
+- [dApp Staking V3 Technical Overview](/docs/about/products/dapp-staking/dapp-staking-protocol.md/)
 
 ### Practical explanation with an example:
 
@@ -159,8 +159,8 @@ The process of application and registration for dApps will not change.
 
 Please, find more information here:
 
-- Requirements: https://docs.astar.network/docs/use/dapp-staking/for-devs/requirements;
-- Registration: https://docs.astar.network/docs/use/dapp-staking/for-devs/register-dapp.
+- Requirements: https://docs.astar.network/docs/about/products/dapp-stakingfor-devs/requirements;
+- Registration: https://docs.astar.network/docs/about/products/dapp-stakingfor-devs/register-dapp.
 
 ***❗ Once the dApp has been registered, stakers can stake on it immediately, and the dApp can earn rewards from the era in which it was registered.***
 
@@ -206,7 +206,7 @@ Ledger users will still be able to withdraw funds from dApp staking, they only w
 Ledger is currently developing a new generic app for all Polkadot/Kusama parachains, and that should be available soon (within months). Once that’s available, Ledger native users will be able to participate in dApp staking V3.
 
 **What can I do right now?**
-If you wish to actively participate in dApp Staking v3 from the start, you should [initiate the unbonding period immediately](https://docs.astar.network/docs/use/dapp-staking/dapp-staking-v2/unbonding) and move your funds to either an Astar EVM Account supported by Ledger (see below), or move funds to a hot wallet.
+If you wish to actively participate in dApp Staking v3 from the start, you should [initiate the unbonding period immediately](https://docs.astar.network/docs/about/products/dapp-stakingdapp-staking-v2/unbonding) and move your funds to either an Astar EVM Account supported by Ledger (see below), or move funds to a hot wallet.
 
 :::info
 It is possible that by the dApp staking v3 launch Ledger generic app will be available, completely removing this limitation.

docs/about/products/dapp-staking/for-devs/index.md

@@ -4,37 +4,37 @@ import Figure from "/src/components/figure"
 
 ## Overview
 
-Discover [dApp Staking] (/docs/learn/dapp-staking/),  **LINK TO UPDATE** a unique mechanism that allows communities to support their favorite teams by staking ASTR or SDN with them. When staking ASTR or SDN on a dApp, users not only support the development of innovative apps but also receive staking rewards from inflation.
+Discover [dApp Staking] (/docs/about/products/dapp-staking/),  **LINK TO UPDATE** a unique mechanism that allows communities to support their favorite teams by staking ASTR or SDN with them. When staking ASTR or SDN on a dApp, users not only support the development of innovative apps but also receive staking rewards from inflation.
 
-You can educate yourself more by reading the technical documentation about [dApp Staking] (/docs/learn/dapp-staking/). **LINK TO UPDATE**
+You can educate yourself more by reading the technical documentation about [dApp Staking] (/docs/about/products/dapp-staking/). **LINK TO UPDATE**
 
 **Are you a product owner and want to list your dApp in our staking mechanism to earn rewards?**  
 
 Please take the following parameters into consideration and make sure you meet the [requirements](/use/how-to-guides/layer-1/dapp-staking/for-devs/requirements.md):
 
 :::tip
 
-Before reading the dApp Staking section for dApp owner, make sure you understand the concept of periods, subperiods and eras, as well as the dApp Staking V3 parameters explained [here] (/docs/learn/dapp-staking/#period--subperiods).  **LINK TO UPDATE**
+Before reading the dApp Staking section for dApp owner, make sure you understand the concept of periods, subperiods and eras, as well as the dApp Staking V3 parameters explained [here] (/docs/about/products/dapp-staking/#period--subperiods).  **LINK TO UPDATE**
 
 :::
 
 ### Tier System and Rewards
 
-dApp Staking introduces the concept of a tier system for dApps. It's important to fully understand the [tier mechanism] (/docs/learn/dapp-staking/dapp-staking-protocol#tier-system) before proceeding with dApp Staking application and registration as a dApp owner.  **LINK TO UPDATE**
+dApp Staking introduces the concept of a tier system for dApps. It's important to fully understand the [tier mechanism] (/docs/about/products/dapp-staking/dapp-staking-protocol#tier-system) before proceeding with dApp Staking application and registration as a dApp owner.  **LINK TO UPDATE**
 
-Currently, there are **4 tiers** with a limited number of slots per tier. Tier capacity for dApp staking is calculated at the start of each period based on the ASTR price as described [here] (/docs/learn/dapp-staking/dapp-staking-protocol#tier-system).   **LINK TO UPDATE**
+Currently, there are **4 tiers** with a limited number of slots per tier. Tier capacity for dApp staking is calculated at the start of each period based on the ASTR price as described [here] (/docs/about/products/dapp-staking/dapp-staking-protocol#tier-system).   **LINK TO UPDATE**
 
 The slots allocated to each tier can be viewed on the [dApp Staking Page](https://portal.astar.network/astar/dapp-staking/discover) of the Astar Portal.
 
 At the end of each **Build&Earn** subperiod, dApps are assigned to a tier based on the total value staked on them by users. Each tier has a **threshold** that a dApp must reach in order to access it.
 
-The threshold for tier 4 is fixed, but for the other tiers, the threshold is **dynamic** and calculated at the start of each new period based on the total number of slots for the period. To find out more, [click here] (/docs/learn/dapp-staking/dapp-staking-protocol#tier-threshold-entry).  **LINK TO UPDATE**
+The threshold for tier 4 is fixed, but for the other tiers, the threshold is **dynamic** and calculated at the start of each new period based on the total number of slots for the period. To find out more, [click here] (/docs/about/products/dapp-staking/dapp-staking-protocol#tier-threshold-entry).  **LINK TO UPDATE**
 
 **Rewards** for dApps are also **dynamic**, fluctuating from tier to tier. The higher the tier, the greater the number of ASTR tokens allocated from inflation as rewards for that tier.
 
 The rewards of a tier are divided between all available slots and distributed to the dApps occupying slots. This means that the rewards for dApps within a tier are the same for each dApp, even if not all slots within a tier are occupied.
 
-*Refer to the [dApp staking parameters] (/docs/learn/dapp-staking/protocol-parameters#network-values) page to find out more about the tier system and reward allocation.*  **LINK TO UPDATE**
+*Refer to the [dApp staking parameters] (/docs/about/products/dapp-staking/protocol-parameters#network-values) page to find out more about the tier system and reward allocation.*  **LINK TO UPDATE**
 
 :::tip
 You have to claim your rewards to receive them. We recommend that you claim your rewards at least once a week or, optimistically, 2 or 3 times a week.
@@ -62,7 +62,7 @@ In the event that a dApp is **unregistered** from dApp Staking following a gover
 
 :::
 
-In case you have any questions, please check the [FAQ page] (/docs/learn/dapp-staking/dapp-staking-faq/)  **LINK TO UPDATE** in the Learn section or join our [Discord channel](https://discord.com/invite/astarnetwork).
+In case you have any questions, please check the [FAQ page] (/docs/about/products/dapp-staking/dapp-staking-faq/)  **LINK TO UPDATE** in the Learn section or join our [Discord channel](https://discord.com/invite/astarnetwork).
 
 ### Other pages may be of interest:
 

docs/about/products/dapp-staking/for-devs/manage-dApp-Staking.md

@@ -14,7 +14,7 @@ By clicking on your dApp in the **Your Project** panel, you will have access to
 
 ### Your Dashboard:
 
-- **Curent Tier:** The current tier to which your dApp has been assigned. See [Tier system] (/docs/use/dapp-staking/for-devs/#tier-system-and-rewards) for more information;  **LINK TO UPDATE**
+- **Curent Tier:** The current tier to which your dApp has been assigned. See [Tier system] (/docs/about/products/dapp-stakingfor-devs/#tier-system-and-rewards) for more information;  **LINK TO UPDATE**
 - **Number of stakers:** Total of current stakers on your dApp;
 - **Total Earned:** Total tokens received in the dApp Staking program;