Merge pull request #753 from ethersphere/develop-on-swarm-revisions

first draft of develop on swarm revisions

Author: NoahMaizels

docs/bee/installation/docker.md

@@ -203,7 +203,7 @@ version: 2.6.0-06a0aca7 - planned to be supported until 11 December 2024, please
 "time"="2024-09-24 22:21:19.664897" "level"="info" "logger"="node" "msg"="waiting to sync postage contract data, this may take a while... more info available in Debug loglevel"
 ```
 
-Your node will take some time to finish [syncing postage contract data](https://docs.ethswarm.org/docs/develop/access-the-swarm/buy-a-stamp-batch/) as indicated by the final line:
+Your node will take some time to finish [syncing postage contract data](https://docs.ethswarm.org/docs/develop/tools-and-features/buy-a-stamp-batch/) as indicated by the final line:
 
 ```bash
 "msg"="waiting to sync postage contract data, this may take a while... more info available in Debug loglevel"
@@ -354,7 +354,7 @@ You may also check out the [configuration guide](/docs/bee/working-with-bee/conf
 
 
 ### Access the Swarm
-If you'd like to start uploading or downloading files to Swarm, [start here](/docs/develop/access-the-swarm/introduction).
+If you'd like to start uploading or downloading files to Swarm, [start here](/docs/develop/introduction).
 
 ### Explore the API
 The [Bee API](/docs/bee/working-with-bee/bee-api) is the primary method for interacting with Bee and getting information about Bee. After installing Bee and getting it up and running, it's a good idea to start getting familiar with the API.

docs/bee/installation/fund-your-node.md

@@ -7,7 +7,7 @@ id: fund-your-node
 Bee nodes require **xDAI** (for gas fees) and **xBZZ** (for storage and bandwidth) to function properly. The amount needed depends on your node type and use case.
 
 ### xDAI is Required For:
-- **Buying Postage Stamps** ([Uploading Data](/docs/develop/access-the-swarm/buy-a-stamp-batch))
+- **Buying Postage Stamps** ([Uploading Data](/docs/develop/tools-and-features/buy-a-stamp-batch))
 - **Stake Management Transactions** ([Staking](/docs/bee/working-with-bee/staking/))
 - **Storage Incentives Transactions** ([Redistribution Game](/docs/concepts/incentives/redistribution-game/) )
 - **Chequebook Deployment** ([Bandwidth Payments](/docs/concepts/incentives/bandwidth-incentives/))

docs/bee/installation/package-manager.md

@@ -439,7 +439,7 @@ curl -s localhost:1633/peers | jq ".peers | length"
 
 Perfect! We are accumulating peers, this means you are connected to
 the network, and ready to start [using
-Bee](/docs/develop/access-the-swarm/introduction) to [upload and
+Bee](/docs/develop/introduction) to [upload and
 download](/docs/develop/access-the-swarm/upload-and-download) content or host
 and browse [websites](/docs/develop/access-the-swarm/host-your-website) hosted
 on the Swarm network.
@@ -470,7 +470,7 @@ Storage incentive rewards are only available for full nodes which are providing
 
 
 ### Access the Swarm
-If you'd like to start uploading or downloading files to Swarm, [start here](/docs/develop/access-the-swarm/introduction).
+If you'd like to start uploading or downloading files to Swarm, [start here](/docs/develop/introduction).
 
 ### Explore the API
 The [Bee API](/docs/bee/working-with-bee/bee-api) is the primary method for interacting with Bee and getting information about Bee. After installing Bee and getting it up and running, it's a good idea to start getting familiar with the API.

docs/bee/installation/quick-start.md

@@ -16,8 +16,8 @@ A "light" node can download and upload data from Swarm but does not share its di
 - [Node.js (v18 or higher)](https://nodejs.org/)
 - [npm (Node Package Manager)](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)  
 - [`curl`](https://curl.se/) or [`wget`](https://www.gnu.org/software/wget/) (Check with `curl --version` or `wget --version`)
-- [~0.20 xBZZ on Gnosis Chain](/docs/bee/installation/fund-your-node)
-- [~0.01 xDAI on Gnosis Chain](/docs/bee/installation/fund-your-node)
+- [~0.20 xBZZ on Gnosis Chain](/docs/bee/installation/fund-your-node#how-to-get-xbzz)
+- [~0.01 xDAI on Gnosis Chain](/docs/bee/installation/fund-your-node#how-to-get-xdai)
 
 :::info
 Although `BZZ` is the official symbol of the token on both Ethereum and Gnosis Chain, the term `xBZZ` is widely used by the Swarm community and in documentation to indicate that it is BZZ on Gnosis Chain (not Ethereum).
@@ -256,5 +256,5 @@ Total xBZZ: 0.0000000000000000
 
 ## Next Steps
 
-With your node now fully synced, you're ready start [uploading and downloading](/docs/develop/access-the-swarm/upload-and-download) or start learning how to [develop on Swarm](/docs/develop/introduction).
+With your node now fully synced, you're ready start start learning how to [develop on Swarm](/docs/develop/introduction).
 

docs/bee/installation/shell-script.md

@@ -432,7 +432,7 @@ version: 2.2.0-06a0aca7 - planned to be supported until 11 December 2024, please
 
 Here we can see that after our node has been funded, it was able to issue the transactions for deploying the chequebook contract, which is a prerequisite for running a staking node.
 
-Next your node will begin to sync [postage stamp data](/docs/develop/access-the-swarm/buy-a-stamp-batch), which can take ~5 to 10 minutes. You will see this log message while your node is syncing postage stamp data:
+Next your node will begin to sync [postage stamp data](/docs/develop/tools-and-features/buy-a-stamp-batch), which can take ~5 to 10 minutes. You will see this log message while your node is syncing postage stamp data:
 
 ```bash
 "time"="2024-09-24 22:21:19.664897" "level"="info" "logger"="node" "msg"="waiting to sync postage contract data, this may take a while... more info available in Debug loglevel"
@@ -626,7 +626,7 @@ You may also check out the [configuration guide](/docs/bee/working-with-bee/conf
 
 
 ### Access the Swarm
-If you'd like to start uploading or downloading files to Swarm, [start here](/docs/develop/access-the-swarm/introduction).
+If you'd like to start uploading or downloading files to Swarm, [start here](/docs/develop/introduction).
 
 ### Explore the API
 The [Bee API](/docs/bee/working-with-bee/bee-api) is the primary method for interacting with Bee and getting information about Bee. After installing Bee and getting it up and running, it's a good idea to start getting familiar with the API.

docs/bee/working-with-bee/bee-api.md

@@ -17,7 +17,7 @@ Detailed information about Bee API endpoints can be found in the [API reference
 
 ## Interacting With the API
 
-You can interact with the Bee API using standard HTTP requests, allowing you to programmatically access all of your Bee node's various functions such as [purchasing stamp batches](/docs/develop/access-the-swarm/buy-a-stamp-batch), [uploading and downloading](/docs/develop/access-the-swarm/upload-and-download), [staking](/docs/bee/working-with-bee/staking), and more.
+You can interact with the Bee API using standard HTTP requests, allowing you to programmatically access all of your Bee node's various functions such as [purchasing stamp batches](/docs/develop/tools-and-features/buy-a-stamp-batch), [uploading and downloading](/docs/develop/access-the-swarm/upload-and-download), [staking](/docs/bee/working-with-bee/staking), and more.
 
 ### Alternatives for Working with the API
 

docs/bee/working-with-bee/node-types.md

@@ -19,7 +19,7 @@ Bee can operate in different modes, each tailored to specific use cases:
 | Feature                                                                 | Full Node | Light Node | Ultra-Light Node |
 | ----------------------------------------------------------------------- | --------- | ---------- | ---------------- |
 | Free tier [downloads](/docs/develop/access-the-swarm/upload-and-download)                                                     | ✅        | ✅         | ✅               |
-| [Uploading](/docs/develop/access-the-swarm/upload-and-download) (Can purchase [postage stamp batches](/docs/develop/access-the-swarm/buy-a-stamp-batch))                          | ✅        | ✅         | ❌               |
+| [Uploading](/docs/develop/access-the-swarm/upload-and-download) (Can purchase [postage stamp batches](/docs/develop/tools-and-features/buy-a-stamp-batch))                          | ✅        | ✅         | ❌               |
 | Can exceed free tier downloads                                          | ✅        | ✅         | ❌               |
 | Storage sharing                                                         | ✅        | ❌         | ❌               |
 | [Storage incentives](/docs/bee/working-with-bee/staking/)               | ✅        | ❌         | ❌               |

docs/bee/working-with-bee/swarm-cli.md

@@ -3,10 +3,33 @@ title: Swarm CLI
 id: swarm-cli
 ---
 
-Swarm CLI is a command line based application which simplifies interactions with the Bee API. It allows you to accomplish most common tasks using easy to understand commands. It also greatly simplifies certain more complex tasks, such as as the management of [feeds](/docs/develop/tools-and-features/feeds).  
+**Swarm‑CLI** is a command‑line tool powered by `bee-js` that makes it easy to interact with your Bee node directly from the command line. It’s friendlier than working with the raw Bee HTTP API and faster than writing a custom `bee-js` script when you just want to perform an action from the terminal.
+
+:::tip
+`swarm-cli` is the recommended method for interaction with your Bee node from the command line. Unless you have explicit need to use the Bee API directly, `swarm-cli` is generally the better option.
+:::
+
+Common uses:
+
+* Check your node: `swarm-cli status`
+* Add stake: 
+* Upload files or a static site: `swarm-cli upload <path>` (will prompt to pick or create a postage batch)
+* Download content: `swarm-cli download <reference> -o <output>`
+* Inspect and manage postage batches: `swarm-cli ...` (use `--help` to see stamp-related commands)
+
+**Why use it?**
+
+* **No scaffolding needed** — run direct commands without creating a project
+* **Interactive prompts** — it guides you through common tasks such as stamp purchasing and selection using interactive prompts 
+* **Smart option inference** — it infers options based on your input (e.g., batch selection, index page, content type) so you don’t need deep Bee API knowledge
+* **Powered by `bee-js`** — stays aligned with the latest Bee features
+
+It also greatly simplifies certain more complex tasks, such as as the management of [feeds](/docs/develop/tools-and-features/feeds).  
 
 For installation and usage instructions, [see the README](https://github.com/ethersphere/swarm-cli/blob/master/README.md).
 
 To check the latest version, see the Swarm CLI [releases page](https://github.com/ethersphere/swarm-cli/releases).
 
-For further support and information, [join the Swarm Discord server](https://discord.com/invite/GU22h2utj6).
+For further support and information, [join the Swarm Discord server](https://discord.com/invite/GU22h2utj6).
+
+

docs/concepts/DISC/erasure-coding.md

@@ -35,7 +35,7 @@ Note that this guarantee of retrievability is for each 128 chunk segment, and th
 
 ## Usage
 
-For usage instructions, see the [erasure coding page in the "Develop" section](/docs/develop/access-the-swarm/erasure-coding).
+For usage instructions, see the [erasure coding page in the "Develop" section](/docs/develop/tools-and-features/erasure-coding).
 
 ## Cost Calculation
 

docs/concepts/access-control.md

@@ -6,7 +6,7 @@ id: access-control
 The Access Control Trie (ACT) implements the operation of encryption at the chunk level, with the presence of a decryption/encryption key being the only distinction between accessing private and public data.
 
 :::info
-This article describes the high level concepts and functionalities of ACT. If you're ready to try it out for yourself, please refer to this [hands on usage guide with specific details](/docs/develop/tools-and-features/act).
+This article describes the high level concepts and functionalities of ACT. If you're ready to try it out for yourself, please refer to this [hands on usage guide with specific details](/docs/develop/access-the-swarm/act/).
 :::
 
 In decentralized public data storage systems like Swarm, data is distributed across multiple nodes. Ensuring