Tooling refactor (#1623)

* init

* cont

Author: LandauRaz

components/Starknet/modules/tools/nav.adoc

@@ -1,8 +1,9 @@
 * Tooling
     ** xref:overview.adoc[Overview]
-    ** xref:core-tools.adoc[Core tools]
-    ** xref:coding-in-cairo.adoc[Tools for coding in Cairo]
-    ** xref:writing-smart-contracts.adoc[Tools for writing smart contracts]
-    ** xref:building-dapps.adoc[Tools for building dApps]
-    ** xref:interacting-with-starknet.adoc[Tools for interacting with Starknet]
-    ** xref:creating-ai-agents.adoc[Tools for creating AI agents]
+    // ** xref:core-tools.adoc[Core tools]
+    ** xref:coding-in-cairo.adoc[Coding in Cairo]
+    ** xref:writing-smart-contracts.adoc[Writing smart contracts]
+    ** xref:building-dapps.adoc[Building dApps]
+    ** xref:interacting-with-starknet.adoc[Interacting with Starknet]
+    ** xref:creating-ai-agents.adoc[Creating AI agents]
+    ** xref:running-devnets.adoc[Working locally]

components/Starknet/modules/tools/pages/building-dapps.adoc

@@ -1,10 +1,10 @@
 = Tools for building Starknet dApps
 
-== Scaffold-Stark
-https://scaffoldstark.com/[Scaffold-Stark^] is built using NextJS, Starknet.js, Scarb, Starknet-React, Starknet Foundry and Typescript, and designed to make it easier for developers to create, deploy and interact with smart contracts.
+== Scaffold Stark
+https://scaffoldstark.com/[Scaffold Stark^] is built using NextJS, Starknet.js, Scarb, Starknet-React, Starknet Foundry and Typescript, and designed to make it easier for developers to create, deploy and interact with smart contracts.
 
 == Starknet Scaffold
-https://www.starknetscaffold.xyz/[Starknet-Scaffold^] is an open-source, up-to-date toolkit for building decentralized applications on Starknet, that help you move from prototyping to production-grade apps seamlessly.
+https://www.starknetscaffold.xyz/[Starknet Scaffold^] is an open-source, up-to-date toolkit for building decentralized applications on Starknet, that help you move from prototyping to production-grade apps seamlessly.
 
 Decentralized applications are at the heart of Starknet. These libraries help developers build Dapps on Starknet and connect to prominent Starknet wallets.
 

components/Starknet/modules/tools/pages/coding-in-cairo.adoc

@@ -1,45 +1,45 @@
 = Tools for coding in Cairo
 
-[#vs-code-cairo-extension]
-== VS Code Cairo extension
+== Scarb
+https://github.com/software-mansion/scarb[Scarb^] is much more than a package manager for Cairo: It is the easiest and most recommended way to build and maintain Cairo code. Developed by Software Mansion and inspired by Cargo for Rust, Scarb includes:
+
+* Initiating a new Cairo project.
+* Compiling Cairo projects.
+* Adding and removing Cairo dependencies.
+* Generating Cairo documentation.
+* Fetching and uploading packages link:https://scarbs.xyz/[Scarbs.xyz], the Cairo Registry.
+* Integrating with the Cairo language server, as well as other tools in the Cairo ecosystem, such as Starknet Foundry and the Dojo gaming engine.
 
+== VS Code Cairo extension
 https://marketplace.visualstudio.com/items?itemName=starkware.cairo1[VS Code Cairo extension^] is an extension for the Microsoft Visual Studio (VS) Code IDE that provides assistance when writing Cairo smart contracts, including live diagnostic highlighting for compile errors, quick fixes with suggestions, code formatting and completion, and more. It integrates with Scarb, and works best when Scarb is installed via `asdf`.
 
-[#usc]
-== Universal-Sierra-Compiler
-https://github.com/software-mansion/universal-sierra-compiler[Universal-Sierra-Compiler^] is a utility tool for compiling single Sierra files (unlike Scarb, which compiles full projects) from any Sierra version into CASM.
+== Universal Sierra Compiler
+https://github.com/software-mansion/universal-sierra-compiler[Universal Sierra Compiler^] is a utility tool for compiling single Sierra files (unlike Scarb, which compiles full projects) from any Sierra version into CASM.
 
 [NOTE]
 ====
-Universal-Sierra-Compiler comes bundled with Starknet Foundry and does not need to be installed separately if Starknet Foundry is installed.
+Universal Sierra Compiler comes bundled with Starknet Foundry and does not need to be installed separately if Starknet Foundry is installed.
 ====
 
-[#cairo-profiler]
-== cairo-profiler
-https://github.com/software-mansion/cairo-profiler[cairo-profiler^] is a utility tool that can be used to create profiles of Cairo executions from execution traces, which can be analyzed and used to show flame graphs and other useful information.
+== Cairo Profiler
+https://github.com/software-mansion/cairo-profiler[Cairo Profiler^] is a utility tool that can be used to create profiles of Cairo executions from execution traces, which can be analyzed and used to show flame graphs and other useful information.
 
 [NOTE]
 ====
-cairo-profiler comes bundled with Starknet Foundry and does not need to be installed separately if Starknet Foundry is installed.
+Cairo Profiler comes bundled with Starknet Foundry and does not need to be installed separately if Starknet Foundry is installed.
 ====
 
-[#cairo-playground]
 == Cairo Playground
-
 https://www.cairo-lang.org/cairovm/[Cairo Playground^] an online tool that can be used to both experiment with Cairo without deploying a smart contract on Starknet, as well as dive deep into the Cairo virtual machine.
 
-[#sierra-analyzer] 
 == Sierra Analyzer
-
 https://github.com/FuzzingLabs/sierra-analyzer[Sierra Analyzer^], developed by https://x.com/fuzzinglabs[FuzzingLabs^] is a security toolkit for analyzing Sierra files, including decompiling a Sierra file, printing the contract's control flow graph, and running static analysis detectors.
 
-== Cairo lint
-
-https://github.com/software-mansion/cairo-lint[Cairo lint^] is a collection of lints that can either be used as either a library or as a standalone binary to help both detect and fix common mistakes and improve your Cairo code.
-
-== Stark-utils
+== Cairo Lint
+https://github.com/software-mansion/cairo-lint[Cairo Lint^] is a collection of lints that can either be used as either a library or as a standalone binary to help both detect and fix common mistakes and improve your Cairo code.
 
-https://www.stark-utils.xyz/converter[Stark-utils^] is a simple web application that aims to be a toolbox for Cairo developers, allowing you to convert any input to a felt, string, hexadecimal value, and more.
+== Stark Utils
+https://www.stark-utils.xyz/converter[Stark Utils^] is a simple web application that aims to be a toolbox for Cairo developers, allowing you to convert any input to a felt, string, hexadecimal value, and more.
 
 == Thoth
 https://github.com/FuzzingLabs/thoth[Thoth^] is a Cairo security toolkit that includes analyzers, disassemblers, and decompilers, which enable the generation of call, control-flow, and data-flow graphs for Sierra and Casm files, as well as other advanced tools, such as a symbolic execution engine and a symbolic bounded model checker.

components/Starknet/modules/tools/pages/core-tools.adoc

@@ -1,32 +1,7 @@
 = Core Starknet devtools
 
-== Scarb
-https://github.com/software-mansion/scarb[Scarb^] is much more than a package manager for Cairo: It is the easiest and most recommended way to build and maintain Cairo code. Developed by Software Mansion and inspired by Cargo for Rust, Scarb includes:
-
-* Initiating a new Cairo project.
-* Compiling Cairo projects.
-* Adding and removing Cairo dependencies.
-* Generating Cairo documentation.
-* Fetching and uploading packages link:https://scarbs.xyz/[Scarbs.xyz], the Cairo Registry.
-* Integrating with the Cairo language server, as well as other tools in the Cairo ecosystem, such as Starknet Foundry and the Dojo gaming engine.
-
 == Starknet Foundry
 https://github.com/foundry-rs/starknet-foundry[Starknet Foundry^] is the go-to toolchain for developing Starknet smart contracts, which includes:
 
-* `snforge`, a command line interface that enables using of various "cheatcodes" for testing various aspects of the contracts, such as setting caller address, manipulating the timestamp and block number, forking the chain at a specific block, getting accurate gas and resource reports, profiling and more.
-
-* `sncast`, a command line interface with Starknet Foundry projects that enable to interact with Starknet with deep integration, including declaring, deploying, and interacting with contracts, deploying accounts, and more.
-
-== Starknet Devnet
-https://github.com/0xSpaceShard/starknet-devnet[Starknet Devnet^], developed by SpaceShard, is a Rust implementation of a local Starknet node that includes many featured tailored for testing and development, which are not present on testnet or mainnet, including:
 
-* Pre-deployed and pre-funded accounts
-* Forking the chain at a specific block.
-* Dumping current state (and loading in future runs)
-* Impersonating account
-* Mock L1<>L2 communication
 
-[NOTE]
-====
-https://github.com/0xSpaceShard/starknet-devnet-js[Starknet Devnet JS^] is a JavaScript package that abstracts the Starknet Devnet API, making it easier to interact with it and write end-to-end tests for L1<>L2 communications.
-====

components/Starknet/modules/tools/pages/interacting-with-starknet.adoc

@@ -1,5 +1,8 @@
 = Tools for interacting with Starknet
 
+== Starknet Foundry's `sncast`
+https://foundry-rs.github.io/starknet-foundry/starknet/sncast-overview.html[Starknet Foundry's `sncast`^] is a command line interface with Starknet Foundry projects that enable to interact with Starknet with deep integration, including declaring, deploying, and interacting with contracts, deploying accounts, and more.
+
 == Starkli
 https://github.com/xJonathanLEI/starkli/[Starkli^], developed by https://x.com/xjonathanlei[Jonathan Lei^], is a fast command-line interface for interacting with Starknet. It supports fetching data from the Starknet network, deploying accounts, interacting with contracts, and other useful utilities for developers. 
 

components/Starknet/modules/tools/pages/overview.adoc

@@ -2,7 +2,7 @@
 
 To support its unique architecture, Starknet boasts its own xref:#list_of_tools[suite of developer tools] (also known as _devtools_) that aim to streamline the development process for Starknet developers. While sometimes developed in coordination with StarkWare, the majority of these tools are community-driven projects, showcasing the collaborative and innovative spirit of the Starknet ecosystem.
 
-Starknet's xref:core-tools.adoc[core devtools] include Scarb, Starknet Foundry, and Starknet Devnet. For ease of navigation, additional tools are categorized by context, including xref:coding-in-cairo.adoc[tools for coding in Cairo], xref:writing-smart-contracts.adoc[tools for writing smart contract], xref:building-dapps.adoc[tools for building dApps], xref:interacting-with-starknet.adoc[tools for interacting with Starknet], and xref:creating-ai-agents.adoc[tools for creating AI agents].
+For ease of navigation, the tools in this section are categorized by context, including xref:coding-in-cairo.adoc[tools for coding in Cairo], xref:writing-smart-contracts.adoc[tools for writing smart contracts], xref:building-dapps.adoc[tools for building dApps], xref:interacting-with-starknet.adoc[tools for interacting with Starknet], xref:creating-ai-agents.adoc[tools for creating AI agents], and xref:running-devnets[tools for working locally].
 
 [NOTE]
 ====

components/Starknet/modules/tools/pages/running-devnets.adoc

@@ -1,4 +1,10 @@
-= Tools for running a Starknet devnet
+= Tools for working locally
+
+== Starknet Devnet
+https://github.com/0xSpaceShard/starknet-devnet[Starknet Devnet^], developed by SpaceShard, is a Rust implementation of a local Starknet node that includes many featured tailored for testing and development, which are not present on testnet or mainnet.
+
+== Starknet Devnet JS
+https://github.com/0xSpaceShard/starknet-devnet-js[Starknet Devnet JS^] is a JavaScript package that abstracts the Starknet Devnet API, making it easier to interact with it and write end-to-end tests for L1<>L2 communications.
 
 == Katana
-https://book.dojoengine.org/toolchain/katana[Katana], developed by https://cartridge.gg/[Cartridge^], is an extremely fast devnet designed to support local development with the https://github.com/dojoengine/dojo[Dojo Starknet gaming engine] but can be used as a general purpose devnet as well.
+https://book.dojoengine.org/toolchain/katana[Katana^], developed by https://cartridge.gg/[Cartridge^], is an extremely fast devnet designed to support local development with the https://github.com/dojoengine/dojo[Dojo Starknet gaming engine^] but can be used as a general purpose devnet as well.

components/Starknet/modules/tools/pages/writing-smart-contracts.adoc

@@ -1,11 +1,10 @@
 = Tools for writing Starknet smart contracts
 
-[#starknet-remix-plugin]
-== Starknet Remix plugin
+== Starknet Foundry's `snforge`
+https://foundry-rs.github.io/starknet-foundry/testing/running-tests.html[Starknet Foundry's `snforge`^] is a command line interface that enables using of various "cheatcodes" for testing various aspects of the contracts, such as setting caller address, manipulating the timestamp and block number, forking the chain at a specific block, getting accurate gas and resource reports, profiling and more.
 
+== Starknet Remix plugin
 https://remix-project.org[Remix^] is a browser-based integrated development environment (IDE) for Ethereum that you can use for learning, experimenting and finding vulnerabilities in smart contracts, without installing anything. https://github.com/NethermindEth/starknet-remix-plugin[Starknet Remix plugin^] lets you use Remix for testing Starknet smart contracts, so you can focus on learning Cairo and Starknet in the comfort of your browser. The plugin is also integrated with https://starknet-by-example.voyager.online/[Starknet By Example^], a rich repository of practical learning content.
 
-[#open-zeppelin-contract-wizard]
 == Open Zeppelin Contract Wizard
-
 https://wizard.openzeppelin.com/cairo[Open Zeppelin Contract Wizard^] is a tool that helps you create smart contracts with Open Zeppelin libraries by easily toggling on and off features for popular smart contract patterns.