Guides refactor (#1672)

LandauRaz · web-flow · commit 52df2d0ac2e7 · 2025-07-07T00:20:17.000+03:00
* init

* cont
diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc
@@ -9,13 +9,13 @@ Whether you're a writing Starknet smart contracts and dApps or contributing to t
 
 If you're completely new to Starknet or its programming language, https://www.cairo-lang.org/[Cairo^], we suggest first checking out https://www.starknet.io/what-is-starknet/[_What is Starknet?_^] and coming back whenever you're ready (don't worry, we'll still be here). Otherwise:
 
-🦮 Go to _Guides_ to keep talking to a minimum and follow Starknet's lead
+🚀 Go to _Quickstart_ to begin your Starknet journey as a builder or validator (or both!)
 
-🏛️ Go to _Architecture_ to learn about Starknet's unique features and design
+🏛️ Go to _Architecture_ to deep dive into Starknet's unique design and features 
 
-🛠️ Go to _Tooling_ to harness the power of Starknet's toolchain
+🛠️ Go to _Tooling_ to learn how to harness the power of Starknet's toolchain
 
-🌍 Go to _Ecosystem_ to explore Starknet's third-party landscape
+🌍 Go to _Ecosystem_ to explore Starknet's vast third-party landscape
 
 📚 Go to _Resources_ to browse through various other useful materials 
 
diff --git a/modules/guides/nav.adoc b/modules/guides/nav.adoc
@@ -1,13 +1,13 @@
-* Guides
-    ** Quickstart
+* Quickstart
+    ** Deploy your first contract
         *** xref:quickstart/overview.adoc[Overview]
         *** xref:quickstart/environment-setup.adoc[Setting up your environment]
         *** xref:quickstart/hellostarknet.adoc[Generating and understanding `HelloStarknet`]
         *** xref:quickstart/devnet.adoc[Declaring, deploying, and interacting with `HelloStarknet` locally]
         *** xref:quickstart/sepolia.adoc[Deploying and interacting with `HelloStarknet` on Sepolia]
         *** xref:quickstart/next-steps.adoc[Recommended next steps]
         *** xref:quickstart/troubleshooting.adoc[Troubleshooting]
-    ** Becoming a validator
+    ** Become a validator
         *** xref:becoming-a-validator/overview.adoc[Overview]
         *** xref:becoming-a-validator/prerequisite.adoc[Prerequisites]
         *** xref:becoming-a-validator/stake.adoc[Staking STRK]
diff --git a/modules/guides/pages/becoming-a-validator/next-steps.adoc b/modules/guides/pages/becoming-a-validator/next-steps.adoc
@@ -1,6 +1,6 @@
 = Recommended next steps as a Starknet validator
 
-Welcome to the fourth and final installment of the _Becoming a Starknet validator_ guide! ✅
+Welcome to the fourth and final installment of the _Become a Starknet validator_ guide! ✅
 
 By now you're successfully running your own Pathfinder full node on Sepolia testnet that is attesting to new blocks (way to go!). This last installment of the guide will therefore list the various next steps you can take on your Starknet journey:
 
diff --git a/modules/guides/pages/becoming-a-validator/overview.adoc b/modules/guides/pages/becoming-a-validator/overview.adoc
@@ -1,4 +1,4 @@
-= Becoming a Starknet validator guide overview
+= _Become a Starknet validator_ guide overview
 
 Welcome to the official guide for becoming a Starknet validator! ✅
 
diff --git a/modules/guides/pages/becoming-a-validator/pathfinder.adoc b/modules/guides/pages/becoming-a-validator/pathfinder.adoc
@@ -7,7 +7,7 @@ For any questions or inquiries, reach out to us on https://t.me/+CLZl_F_Nj2RlNjU
 
 == Overview
 
-Welcome to the third installment of the _Becoming a Starknet validator_ guide! ✅
+Welcome to the third installment of the _Become a Starknet validator_ guide! ✅
 
 Starting from its second phase, the staking protocol also requires validators to prove they are actively preserving the history of the network by running a xref:ecosystem:overview.adoc[Starknet full node] and submitting attestations to randomly assigned blocks in each epoch. This installment of the series will therefore walk you though xref:running_a_pathfinder_node[running a Pathfinder node] and xref:running_pathfinders_attestation_service[its attestation service].
 
diff --git a/modules/guides/pages/becoming-a-validator/prerequisite.adoc b/modules/guides/pages/becoming-a-validator/prerequisite.adoc
@@ -7,7 +7,7 @@ For any questions or inquiries, reach out to us on https://t.me/+CLZl_F_Nj2RlNjU
 
 == Overview
 
-Welcome to the first installment of the _Becoming a Starknet validator_ guide! ✅
+Welcome to the first installment of the _Become a Starknet validator_ guide! ✅
 
 Following this guide requires Docker, an exported Ethereum URL and three exported Starknet account. This installment of the guide will therefore walk you through xref:installing_docker[installing Docker] and exporting xref:exporting_an_ethereum URL[an Ethereum URL] and xref:exporting_accounts[the required accounts].
 
diff --git a/modules/guides/pages/becoming-a-validator/stake.adoc b/modules/guides/pages/becoming-a-validator/stake.adoc
@@ -7,7 +7,7 @@ For any questions or inquiries, reach out to us on https://t.me/+CLZl_F_Nj2RlNjU
 
 == Overview
 
-Welcome to the second installment of the _Becoming a Starknet validator_ guide! ✅
+Welcome to the second installment of the _Become a Starknet validator_ guide! ✅
 
 To become a validator, you must stake least the minimum required amount of STRK tokens by locking them into Starknet's Staking contract, subsequentially earning rewards based on your participation. This installment of the guide will therefore walk you through xref:approving_strk_transfer[approving a transfer of STRK tokens to the Staking contract], xref:locking_strk[locking them into it], and xref:verifying_stakes[verifying that the procedure was successful].
 
diff --git a/modules/guides/pages/quickstart/devnet.adoc b/modules/guides/pages/quickstart/devnet.adoc
@@ -6,7 +6,7 @@ include::partial$snippet-important-troubleshooting.adoc[]
 
 == Introduction
 
-Welcome to the third installment of the "Hello, Starknet!" quickstart series, the official tutorial for starting your journey as a Starknet developer! 🚀
+Welcome to the third installment of the  _Deploy your first Starknet contract_ guide! 🥇
 
 Local networks, also known as development networks or _devnets_, enable a fast and private development process, making them ideal for taking your first Starknet steps. This installment of the series will therefore guide you through the steps necessary to declare, deploy, and interact with the `HelloStarknet` contract on your very own local instance of Starknet.
 
diff --git a/modules/guides/pages/quickstart/environment-setup.adoc b/modules/guides/pages/quickstart/environment-setup.adoc
@@ -5,7 +5,7 @@ include::partial$snippet-important-troubleshooting.adoc[]
 
 == Introduction
 
-Welcome to the first installment of the "Hello, Starknet!" quickstart series, the official tutorial for starting your journey as a Starknet developer! 🚀
+Welcome to the first installment of the _Deploy your first Starknet contract_ guide! 🥇
 
 As a popular phrase (often attributed to Abraham Lincoln) says, "Give me six hours to chop down a tree, and I will spend the first four sharpening the axe". The first installment of the series will therefore guide you through setting up your development environment, which will include the three most recommended tools to begin developing on Starknet:
 
diff --git a/modules/guides/pages/quickstart/hellostarknet.adoc b/modules/guides/pages/quickstart/hellostarknet.adoc
@@ -4,7 +4,7 @@ include::partial$snippet-important-troubleshooting.adoc[]
 
 == Introduction
 
-Welcome to the second installment of the "Hello, Starknet!" quickstart series, the official tutorial for starting your journey as a Starknet developer! 🚀
+Welcome to the second installment of the _Deploy your first Starknet contract_ guide! 🥇
 
 Starknet contracts are a special superset of Cairo programs that are run by the Starknet sequencer, and as such, have access to Starknet's state. This installment of the series will therefore walk you though generating and understanding Scarb's default `HelloStarknet` contract, which will be used throughout the following installments.
 
diff --git a/modules/guides/pages/quickstart/next-steps.adoc b/modules/guides/pages/quickstart/next-steps.adoc
@@ -1,14 +1,14 @@
 [id="next-steps]
 
-= Recommended next steps on your Starknet journey
+= Recommended next steps after deploying your first contract
 
-Welcome to the fifth and final installment of the "Hello, Starknet!" quickstart series, the official tutorial for starting your journey as a Starknet developer! 🚀
+Welcome to the fifth and final installment of the _Deploy your first Starknet contract_ guide! 🥇
 
-By now you've successfully declared, deployed, and interacted with the `HelloStarknet`, both on Starknet Sepolia and locally (way to go!). This last installment of the series will therefore list the various next steps you can take on your Starknet journey:
+By now you've successfully declared, deployed, and interacted with the `HelloStarknet`, both on Starknet Sepolia and locally (way to go!). This last installment of the series will therefore list the various paths you can walk next:
 
-* Learn more about Starknet's xref:architecture:accounts.adoc[architecture], xref:tools:overview.adoc[tooling], or xref:ecosystem:overview.adoc[ecosystem]
+* Learn more about Starknet's xref:architecture:overview.adoc[architecture], xref:tools:overview.adoc[tooling], or xref:ecosystem:overview.adoc[ecosystem]
 * Watch the latest https://starknet.notion.site/Starknet-Basecamp-Hub-1541b3c1f49f439da872d3d71647d834[Starknet Basecamp^], or join an upcoming one
 * Complete the https://starklings.app/[Starklings^] and https://speedrunstark.com/[Speedrun Stark^] coding challenges
-* Apply for a https://www.starknet.io/grants/[seed or growth grant^] 
+* Use the https://www.cairo-coder.com/[Cairo Coder^] to vibe code a Starknet dApp https://x.com/akashneelesh/status/1937604905809617339[in under 15 minutes^]
 
 Good luck and welcome aboard! We can't wait to see the new and innovative things you'll bring to Starknet 🌟
diff --git a/modules/guides/pages/quickstart/overview.adoc b/modules/guides/pages/quickstart/overview.adoc
@@ -1,8 +1,8 @@
-= "Hello, Starknet!" quickstart series overview
+= _Deploy your first Starknet contract_ guide overview
 
-Welcome to the "Hello, Starknet!" quickstart series, the official tutorial for starting your journey as a Starknet developer! 🚀
+Welcome to the official guide for deploying your first Starknet contract! 🥇
 
-This series will walk you though all the steps necessary to deploy your very own `HelloStarknet` contract, including:
+This guide will walk you though all the steps necessary to deploy your very own `HelloStarknet` contract, including:
 
 * xref:quickstart/environment-setup.adoc[]
 * xref:quickstart/hellostarknet.adoc[]
diff --git a/modules/guides/pages/quickstart/sepolia.adoc b/modules/guides/pages/quickstart/sepolia.adoc
@@ -6,7 +6,7 @@ include::partial$snippet-important-troubleshooting.adoc[]
 
 == Introduction
 
-Welcome to the fourth installment of the "Hello, Starknet!" quickstart series, the official tutorial for starting your journey as a Starknet developer! 🚀
+Welcome to the fourth installment of the  _Deploy your first Starknet contract_ guide! 🥇
 
 Starknet Sepolia is Starknet's testnet environment designed to provide developers with a testing ground that mirrors the behavior of the Starknet Mainnet while being connected to the Ethereum Sepolia testnet, making it ideal for debugging and optimizing your code before deploying it to production. This installment of the series will therefore guide you through the steps necessary to deploy and interact with the `HelloStarknet` contract on Starknet Sepolia.
 
diff --git a/modules/guides/pages/quickstart/troubleshooting.adoc b/modules/guides/pages/quickstart/troubleshooting.adoc
@@ -1,4 +1,4 @@
-= "Hello, Starknet!" quickstart tutorial troubleshooting
+= _Deploy your first Starknet contract_ guide troubleshooting
 
 == Setting up your environment
 

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-= Becoming a Starknet validator guide overview`
	`1`	`+= _Become a Starknet validator_ guide overview`
`2`	`2`
`3`	`3`	`Welcome to the official guide for becoming a Starknet validator! ✅`
`4`	`4`