Tooling nav refactor #1640

LandauRaz · web-flow · commit 01639c859de5 · 2025-06-20T08:05:51.000-04:00
diff --git a/components/Starknet/modules/tools/nav.adoc b/components/Starknet/modules/tools/nav.adoc
@@ -1,9 +1,20 @@
 * Tooling
     ** xref:overview.adoc[Overview]
-    // ** 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]
+    ** https://docs.swmansion.com/scarb/[Scarb ↗^]
+    ** https://foundry-rs.github.io/starknet-foundry/[Starknet Foundry ↗^]
+    ** https://0xspaceshard.github.io/starknet-devnet/[Starknet Devnet ↗^]
+    ** Software Development Kits
+    *** https://starknetjs.com/[Javascript ↗^]
+    *** https://starknetpy.readthedocs.io/en/latest/[Python ↗^]
+    *** https://github.com/xJonathanLEI/starknet-rs?tab=readme-ov-file#starknet-rs[Rust ↗^]
+    *** https://pkg.go.dev/github.com/NethermindEth/starknet.go#section-readme[Go ↗^]
+    *** https://github.com/software-mansion/starknet-jvm?tab=readme-ov-file#-starknet-jvm-[Java ↗^]
+    *** https://github.com/software-mansion/starknet.swift?tab=readme-ov-file#starknetswift[Swift ↗^]
+    *** https://starknetdart.dev/[Dart ↗^]
+    ** Additional 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]
diff --git a/components/Starknet/modules/tools/pages/coding-in-cairo.adoc b/components/Starknet/modules/tools/pages/coding-in-cairo.adoc
@@ -1,18 +1,20 @@
 = Tools for coding in Cairo
 
-== 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`.
 
+== 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
+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.
+
+== 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.
+
 == 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.
 
@@ -29,17 +31,10 @@ https://github.com/software-mansion/cairo-profiler[Cairo Profiler^] is a utility
 Cairo Profiler comes bundled with Starknet Foundry and does not need to be installed separately if Starknet Foundry is installed.
 ====
 
-== 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
-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
-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.
+[NOTE]
+====
+Cairo Lint comes bundled with Scarb and does not need to be installed separately if Scarb is installed.
+====
diff --git a/components/Starknet/modules/tools/pages/core-tools.adoc b/components/Starknet/modules/tools/pages/core-tools.adoc
diff --git a/components/Starknet/modules/tools/pages/interacting-with-starknet.adoc b/components/Starknet/modules/tools/pages/interacting-with-starknet.adoc
@@ -1,67 +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. 
 
-== Starknet SDKs
-A Software Development Kit (SDK) is a library that abstracts the complexities of Starknet when building transactions and interacting with the blockchain. SDKs implement the Starknet https://github.com/starkware-libs/starknet-specs[JSON RPC specification^], and are updated to support the latest API changes. There are SDKs for various languages, so you can choose the SDK according to your needs.
-
-[%autowidth]
-|===
-| Language | Maintainer | Code | Package | Docs | Support  
-
-| JavaScript / TypeScript
-| https://x.com/0xSpaceShard[SpaceShard^]
-| https://github.com/starknet-io/starknet.js[starknet.js on GitHub^]
-| https://www.npmjs.com/package/starknet[starknet.js on NPM^]
-| https://www.starknetjs.com/[starknet.js Book^]
-| https://discord.gg/starknet-community[starknet.js channel on Starknet Discord^]
- 
-| Python
-| https://x.com/swmansionxyz[Software Mansion^]
-| https://github.com/software-mansion/starknet.py[starknet.py on GitHub^]
-| https://pypi.org/project/starknet-py/[starknet.py on PyPi^]
-| https://starknetpy.rtfd.io/[starknet.py Docs^]
-| https://t.me/starknetpy[starknet.py on Telegram^]
-
-| Rust
-| https://x.com/xjonathanlei[Jonathan Lei^]
-| https://github.com/xJonathanLEI/starknet-rs[starknet-rs on GitHub^]
-| https://crates.io/crates/starknet[starknet-rs on Crates^]
-| https://github.com/xJonathanLEI/starknet-rs[starknet-rs Docs^] | https://t.me/starknet_rs[starknet-rs on Telegram^]
-
-| Go
-| https://x.com/NethermindEth[Nethermind^]
-| https://github.com/NethermindEth/starknet.go[starknet.go on GitHub^]
-| N/A
-| https://pkg.go.dev/github.com/NethermindEth/starknet.go[starknet.go Docs^]
-| https://t.me/StarknetGo[starknet.go on Telegram^]
-
-| Java
-| https://x.com/swmansionxyz[Software Mansion^]
-| https://github.com/software-mansion/starknet-jvm[starknet-jvm on GitHub^]
-| https://central.sonatype.com/artifact/com.swmansion.starknet/starknet[starknet-jvm on Maven]
-| https://docs.swmansion.com/starknet-jvm/[starknet-jvm Docs^]
-| N/A
-
-| Swift
-| https://x.com/swmansionxyz[Software Mansion]
-| https://github.com/software-mansion/starknet.swift[starknet.swift on GitHub^]
-| N/A
-| https://docs.swmansion.com/starknet.swift/documentation/starknet/[starknet.swift Docs^]
-| N/A
-
-| Dart
-| https://x.com/focustree_app[Focustree^]
-| https://github.com/focustree/starknet.dart[starknet.dart on GitHub^]
-| https://pub.dev/packages/starknet[starknet.dart on Pub^]
-| https://starknetdart.dev/[starknet.dart Docs^]
-| https://t.me/+CWezjfLIRYc0MDY0[starknet.dart on Telegram^]
-|===
-
 == Entro
 https://github.com/NethermindEth/entro[Entro^] helps decoding and analyzing Starknet transactions and events, including decoding contract ABI and transaction data and getting contract class history, 
 
diff --git a/components/Starknet/modules/tools/pages/overview.adoc b/components/Starknet/modules/tools/pages/overview.adoc
@@ -1,8 +1,8 @@
-= Starknet developer tools overview
+= Starknet tooling overview
 
-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.
+To support its unique architecture, Starknet boasts its own 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.
 
-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].
+Starknet's core tools include its build toolchain and package manager _Scarb_, smart contract development toolchain _Starknet Foundry_, local node implementation _Starknet Devnet_, and various software development kits (also known as _SDKs_). 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 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]
 ====
diff --git a/components/Starknet/modules/tools/pages/running-devnets.adoc b/components/Starknet/modules/tools/pages/running-devnets.adoc
@@ -1,8 +1,5 @@
 = 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.
 
diff --git a/components/Starknet/modules/tools/pages/writing-smart-contracts.adoc b/components/Starknet/modules/tools/pages/writing-smart-contracts.adoc
@@ -1,8 +1,5 @@
 = Tools for writing Starknet smart contracts
 
-== 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.
 
