checking titles for consistency - build

plus the top-level /use section
AstarNetwork · Jun 13, 2024 · f00a7f8 · f00a7f8
1 parent c20b3b7
commit f00a7f8
Show file tree

Hide file tree

Showing 22 changed files with 63 additions and 57 deletions.
diff --git a/docs/build/builder-guides/layer-1/astar-beta-labs/_category_.json b/docs/build/builder-guides/layer-1/astar-beta-labs/_category_.json
diff --git a/...build/builder-guides/layer-1/astar-beta-labs/account-unification/users_guide.md b/...build/builder-guides/layer-1/astar-beta-labs/account-unification/users_guide.md
@@ -1,4 +1,5 @@
 ---
+title: How to Create a Unified Account
 sidebar_position: 2
 ---
 # How to create a unified account

diff --git a/docs/build/builder-guides/layer-1/astar-beta-labs/index.md b/docs/build/builder-guides/layer-1/astar-beta-labs/index.md
@@ -1,3 +1,8 @@
+---
+title: Astar Beta Labs
+position: 3
+---
+
 # Astar Beta Labs
 
 ## Overview

diff --git a/docs/build/builder-guides/layer-1/astar-beta-labs/metamask-snaps/_category_.json b/docs/build/builder-guides/layer-1/astar-beta-labs/metamask-snaps/_category_.json
@@ -1,4 +1,4 @@
 {
-    "label": "MetaMask Snaps",
+    "label": "MetaMask Snap",
     "position": 2
 }
diff --git a/docs/build/builder-guides/layer-1/astar-beta-labs/metamask-snaps/index.md b/docs/build/builder-guides/layer-1/astar-beta-labs/metamask-snaps/index.md
@@ -1,4 +1,4 @@
-# MetaMask Snaps
+# MetaMask Snap
 
 ## Overview
 

diff --git a/docs/build/builder-guides/layer-1/evm/category.json b/docs/build/builder-guides/layer-1/evm/category.json
diff --git a/docs/build/builder-guides/layer-1/evm/index.md b/docs/build/builder-guides/layer-1/evm/index.md
@@ -0,0 +1,4 @@
+---
+title: Build EVM Smart Contracts
+position: 2
+---
diff --git a/docs/build/builder-guides/layer-1/wasm/_category_.json b/docs/build/builder-guides/layer-1/wasm/_category_.json
diff --git a/docs/build/builder-guides/layer-1/wasm/dex/_category_.json b/docs/build/builder-guides/layer-1/wasm/dex/_category_.json
@@ -1,4 +1,4 @@
 {
-  "label": "Build Uniswap V2 core DEX",
+  "label": "Uniswap V2 Core DEX",
   "position": 4
 }
diff --git a/docs/build/builder-guides/layer-1/wasm/dex/dex.md b/docs/build/builder-guides/layer-1/wasm/dex/dex.md
@@ -11,7 +11,7 @@ Experience gained from following the previous guides will be beneficial for this
 
 | Tutorial                                                                   | Difficulty                     |
 |----------------------------------------------------------------------------|--------------------------------|
-| [Your First Flipper Contract](../flipper-contract/flipper-contract.md)              | Basic ink! -  Basic Rust       |
+| [Your First Flipper Contract](../flipper-contract/flipper.md)              | Basic ink! -  Basic Rust       |
 | [NFT contract with PSP34](../nft/nft.md)              | Intermediate ink! -  Basic Rust       |          
 
 In addition to:

diff --git a/docs/build/builder-guides/layer-1/wasm/flipper-contract/_category_.json b/docs/build/builder-guides/layer-1/wasm/flipper-contract/_category_.json
@@ -1,4 +1,4 @@
 {
-  "label": "Your First Flipper Contract",
+  "label": "Flipper Contract",
   "position": 1
 }
diff --git a/docs/build/builder-guides/layer-1/wasm/flipper-contract/flipper.md b/docs/build/builder-guides/layer-1/wasm/flipper-contract/flipper.md
@@ -2,14 +2,14 @@
 sidebar_position: 2
 ---
 
-# Flipper Contract
+# Flipper
 This is step-by-step explanation of the process behind building an ink! smart contract, using a simple app called Flipper. The examples provided within this guide will help you develop an understanding of the basic elements and structure of ink! smart contracts.
 
 ## What is Flipper?
 Flipper is a basic smart contract that allows the user to toggle a boolean value located in storage to either `true` or `false`. When the flip function is called, the value will change from one to the other.
 
 ## Prerequisites
-Please refer to the [previous section](./flipper-contract.md) for the list of prerequisites.
+Please refer to the [previous section](./index.md) for the list of prerequisites.
 
 ## Flipper Smart Contract
 In a new project folder, execute the following:

diff --git a/...wasm/flipper-contract/flipper-contract.md → ...es/layer-1/wasm/flipper-contract/index.md b/...wasm/flipper-contract/flipper-contract.md → ...es/layer-1/wasm/flipper-contract/index.md
diff --git a/docs/build/builder-guides/layer-1/wasm/index.md b/docs/build/builder-guides/layer-1/wasm/index.md
@@ -1,3 +1,8 @@
+---
+title: Build Wasm Smart Contracts
+position: 1
+---
+
 # From Zero to ink! Hero
 
 ```mdx-code-block

diff --git a/docs/build/builder-guides/layer-1/wasm/manic-minter/manic-minter.md b/docs/build/builder-guides/layer-1/wasm/manic-minter/manic-minter.md
@@ -7,7 +7,7 @@ This tutorial is suitable for developers with **intermediate** knowledge of ink!
 
 | Tutorial                                                                   | Difficulty                     |
 |----------------------------------------------------------------------------|--------------------------------|
-| [Your First Flipper Contract](../flipper-contract/flipper-contract.md)              | Basic ink! -  Basic Rust       |
+| [Your First Flipper Contract](../flipper-contract/flipper.md)              | Basic ink! -  Basic Rust       |
 | [NFT contract with PSP34](../nft/nft.md)              | Intermediate ink! -  Basic Rust       |          
 
 

diff --git a/docs/build/builder-guides/layer-1/wasm/nft/nft.md b/docs/build/builder-guides/layer-1/wasm/nft/nft.md
@@ -11,7 +11,7 @@ This tutorial is suitable for developers with **intermediate** knowledge of ink!
 
 | Tutorial                                                                   | Difficulty                     |
 |----------------------------------------------------------------------------|--------------------------------|
-| [Your First Flipper Contract](../flipper-contract/flipper-contract.md)              | Basic ink! -  Basic Rust       | 
+| [Your First Flipper Contract](../flipper-contract/flipper.md)              | Basic ink! -  Basic Rust       | 
 | [Implement Uniswap V2 core DEX](../dex/dex.md) | Advanced ink! - Basic Rust |         
 
 ## How to Start

diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -15,9 +15,16 @@ The Astar documentation portal serves as the official repository of current info
 
 ## Developer Quickstart Guides
 
-- [**Deploy on Astar Substrate EVM Network**](build/build-on-layer-1/smart-contracts/EVM/quickstart-evm.md).
-- [**Deploy on Astar Substrate Native (Wasm) Network**](build/build-on-layer-1/smart-contracts/wasm/index.md).
-- [**Deploy on Astar zkEVM**](build/build-on-layer-2/index.md)
+Learn more about the differences between Astar's Layer 1 and Layer 2 networks, visit the [About Section](/about/networks.md)
+
+### Build and Deploy on Layer 1
+
+- [**Build on Astar Substrate EVM Network**](build/build-on-layer-1/smart-contracts/EVM/quickstart-evm.md).
+- [**Build on Astar Substrate Native Network**](build/build-on-layer-1/smart-contracts/wasm/index.md).
+
+### Build and Deploy on Layer 2
+
+- [**Deploy Smart Contracts on Astar zkEVM**](build/build-on-layer-2/index.md)
 
 ## User Guides
 

diff --git a/docs/use/_category_.json b/docs/use/_category_.json
@@ -1,4 +1,4 @@
 {
-    "label": "Interact with Astar Network",
+    "label": "How to Use the Network",
     "position": 3
 }
diff --git a/docs/use/astar.md b/docs/use/astar.md
diff --git a/docs/use/get-started/blockchain-smart-contracts.md b/docs/use/get-started/blockchain-smart-contracts.md
@@ -1,8 +1,8 @@
 ---
 sidebar_position: 1
-sidebar_label: Smart Contracts Blockchain
-title: High-Level Blockchain & Smart Contracts Overview
+title: What are Smart Contracts on the Blockchain?
 ---
+# Blockchain & Smart Contracts Overview
 
 Astar is a platform for smart contracts deployment.  Developers can create and deploy smart contracts on Astar Network using a variety of programming languages, including Solidity, which is compatible with Ethereum smart contracts or ink!, a Rust-based smart contract language for Polkadot ecosystem. This compatibility ensures a seamless transition for developers from other blockchain ecosystems, fostering interoperability and encouraging the adoption of Astar Network. 
 

diff --git a/docs/use/index.md b/docs/use/index.md
@@ -1,8 +1,28 @@
 ---
-title: Use Astar Network
+title: How to Use the Network
 position: 4
 ---
 
-# How to Interact with Astar Network
+# About Astar Network
 
-If this is your first time here, Welcome! This section is tailored to equip you with the knowledge and skills necessary to navigate through both our Layer 1 and Layer 2 networks confidently. Whether you're new to blockchain or an experienced web3 developer we aim to answer all your basic questions about interacting with the network here.
+[Astar Network]: https://astar.network/ 
+
+Astar Network is Japan's most popular smart contract platform, supporting both EVM and WebAssembly (Wasm) environments, and interoperability between them using a Cross-Virtual Machine. Astar Network is friendly to all kinds of developers, and the tools and languages they already know. Backed by the shared security of Polkadot, Astar shines brilliantly on its own within a vibrant and healthy ecosystem, and in the blockchain industry overall driving international corporate adoption, and consumer interest in Web3 technologies.
+
+## Lack of developer incentives
+
+Astar's Build2Earn system is designed to grow the network in an innovative way, while simultaneously rewarding participants and builders. It allows developers to earn incentives for building and maintaining their decentralized applications, and users to earn incentives for supporting their favorite projects, all while encouraging growth of the ecosystem overall.
+
+## Scalability
+
+Blockchains do not scale by design, mostly due to the security assurances inherent in their decentralized consensus mechanisms. If blockchains were faster, they would be less secure. There is an upper limit to the amount of data that can be stored in individual blocks, and at times of network saturation, users of typical blockchains may notice their transactions sitting unconfirmed or in a pending state for long periods of time, resulting in a poor user experience. 
+
+The solution to the issue, up until now, has been a patchwork of independent blockchains loosely connected by bridges - often subject to attack due to their reliance on custodial elements, with no common security standards or methods of interoperability between all. The idea of 'cross-chain', therefore, has mostly been to copy and paste a smart contract from one blockchain, to another. Projects that create real value are quickly copied and deployed elsewhere for better, or for worse, with almost no real innovation taking place overall.
+
+Astar Network is changing that, and ushering in the next generation of multichain smart contracts uniquely able to utilize the best features from both EVM and WebAssembly Virtual Machines, and any number of application-specific blockchains across the broader Polkadot ecosystem. All while being future-proof.
+
+## Interoperability
+
+This interoperability framework, empowered by the shared security of Polkadot coupled with Astar XVM, allows developers to use and build smart contracts in ways they never have before. By fostering cooperation and integrations across multiple blockchains and applications, complex synergies can be developed, leading to the realization of truly innovative solutions that can't be replicated in any other environment.
+
+Many different blockchains exist, but few have interoperability as their defining feature. Welcome to Astar Network.
diff --git a/docs/use/polkadot/index.md b/docs/use/polkadot/index.md
@@ -0,0 +1,3 @@
+---
+title: Polkadot
+---