refactoring

cmd0s · cmd0s · commit ed0486effbeb · 2025-04-30T18:10:33.000+02:00
diff --git a/docs/index.md b/docs/index.md
@@ -11,7 +11,7 @@ hide:
         </h1>
         <span class="subtitle">documentation</span>
         <p class="description">
-        This documentation provides everything you need to get started with Web3 Pi.<br>Find step-by-step guides for setup, detailed explanations of features, monitoring tools, troubleshooting tips for running your Ethereum node smoothly on Raspberry Pi.
+        This documentation provides everything you need to get started with Web3 Pi.<br>Find step-by-step guides for setup, detailed explanations of features, monitoring tools, troubleshooting and tips for running your Ethereum node smoothly on Raspberry Pi.
         </p>
         <a href="/setup/prerequisites" class="md-button md-button--primary">
             Get Started
diff --git a/docs/introduction/next-steps.md b/docs/introduction/next-steps.md
@@ -19,14 +19,14 @@ If you're unsure, we recommend starting with a single device setup.
 
 Ensure you have all the necessary hardware components (Raspberry Pi, power supply, storage, network cable, etc.).
 
-### Use Your Own Hardware or the Welcome Box?
+### Use Your Own Hardware or the WelcomeBox?
 
-- [**Welcome Box:**](../welcome-box/index.md) Web3 Pi offers a Welcome Box — an all-in-one solution with pre-selected, compatible hardware to help you get started quickly.
+- [**WelcomeBox:**](../welcome-box/index.md) Web3 Pi offers a WelcomeBox — an all-in-one solution with pre-selected, compatible hardware to help you get started quickly.
 - **Own Hardware:** You can use your existing Raspberry Pi (Model 4, 5, or CM4) and compatible peripherals. Ensure you have everything required by checking the [Prerequisites Guide](../setup/prerequisites.md) and the [Hardware Recommendations](./single-mode/hardware-recommendations.md) document.
 
 ### Optional LCD Display?
 
-- You can add an optional LCD display to your setup for at-a-glance monitoring. It's included in the Welcome Box and natively supported by the Web3 Pi system — just plug it in, no installation or configuration needed.  
+- You can add an optional LCD display to your setup for at-a-glance monitoring. It's included in the WelcomeBox and natively supported by the Web3 Pi system — just plug it in, no installation or configuration needed.  
 Details are in the [LCD Monitoring Guide](../monitoring/lcd.md).
 
 ## 3. Set Up Your Node
diff --git a/docs/introduction/staking.md b/docs/introduction/staking.md
@@ -7,7 +7,7 @@
 Running a standard Ethereum node with Web3 Pi does not directly generate income by itself. Its primary purpose is providing secure, private, and performant access to the blockchain. However, Web3 Pi serves as a foundation for potential earning opportunities:
 
 * **Solo Staking:** While running a node doesn't require 32 ETH, staking to secure the network and earn rewards does. Web3 Pi hardware (like Raspberry Pi 5) is capable of handling staking duties (proven in tests running 200 validators), although the setup currently requires manual configuration. We aim to simplify this process significantly in the future.
-* **RPC Monetization:** Through collaborations like the one with Golem Network, there are plans to allow Web3 Pi node operators to share RPC endpoint and potentially earn rewards (e.g., in GLM tokens) for serving requests. (This feature is not yet available.)
+* **RPC Monetization:** Through collaborations like the one with Golem Network, there are plans to allow Web3 Pi node operators to share RPC endpoint and potentially earn rewards (e.g., in GLM tokens) for serving requests. This feature is not yet available.
 
 If you are considering staking, it is crucial that you thoroughly research and understand the process, responsibilities, and significant risks involved before attempting it.
 
diff --git a/docs/setup/dual-mode/hardware-assembly.md b/docs/setup/dual-mode/hardware-assembly.md
@@ -53,5 +53,3 @@ Double-check your labels and component placement one last time.
 ## Next Steps
 
 With both devices assembled correctly, you are ready to connect them to your network and begin the software installation and synchronization process.
-
-➡️ Proceed to the [**Dual-Device Installation Monitoring Guide**](./installation-monitoring.md)
diff --git a/docs/setup/dual-mode/hardware-recommendations.md b/docs/setup/dual-mode/hardware-recommendations.md
@@ -9,7 +9,7 @@ Supported combinations include:
 - Two Raspberry Pi 5
 - Two Raspberry Pi 4
 - One Raspberry Pi 5 and one Raspberry Pi 4
-- Any combination including Compute Module 4 (CM4)
+- Any combination including Compute Module 4/5
 
 ## Raspberry Pi Models
 
diff --git a/docs/setup/dual-mode/software-setup.md b/docs/setup/dual-mode/software-setup.md
@@ -33,7 +33,7 @@ For Dual Mode device, the following settings can be configured. In this mode, we
 
 ## Advanced Options
 
-If you click the Advanced button, you can configure these additional options. These advanced settings will be applied to both the execution layer device and the consensus layer device:
+If you click the **ADVANCED** button, you can configure these additional options. These advanced settings will be applied to both the execution layer device and the consensus layer device:
 
 * **Execution endpoint address:** Optional custom endpoint for execution client
 * **Locale settings:** Including:
@@ -52,7 +52,7 @@ If you click the Advanced button, you can configure these additional options. Th
 
 ## Drive Selection
 
-After setting up the configuration and clicking "Next", a dialog box will appear allowing you to select the drive where the image with settings will be saved.
+After setting up the configuration and clicking **NEXT**, a dialog box will appear allowing you to select the drive where the image with settings will be saved.
 
 * **Drive selection:** The list shows available storage devices
 * **Display options:**
@@ -114,7 +114,7 @@ Now the process of writing the card for the consensus layer device will begin.
 ## Final Steps
 
 Now that you have both cards prepared, you will see a message about the possibility of installing the prepared cards in the appropriate devices.
-At this stage, you can click "Next" and complete the process. In the following steps, you will be able to assemble both devices and install the prepared cards in the corresponding slots.
+At this stage, you can click **NEXT** and complete the process. In the following steps, you will be able to assemble both devices and install the prepared cards in the corresponding slots.
 
 ![Final screen](../img/dual/w3p-inserting.png){ width=700px }
 ![Final screen](../img/dual/w3p-finish.png){ width=700px }
diff --git a/docs/setup/prerequisites.md b/docs/setup/prerequisites.md
@@ -40,6 +40,6 @@ For those who prefer a guaranteed-compatible, all-in-one solution, the [Web3 Pi
 
 If you would prefer to use your own existing Raspberry Pi, please read the [Hardware Checklist](./single-mode/hardware-checklist.md) to make sure you have everything you need. If you need to purchase anything further, the [Hardware Recommendations](./single-mode/hardware-recommendations.md) document will help you choose suitable additions to your existing setup.
 
-Optionally, you can also purchase an [LCD screen](https://www.waveshare.com/1.69inch-lcd-module.htm) for the Pi. This gives you a quick way of checking that your node is functional. The LCD screen is included in the Welcome Box.
+Optionally, you can also purchase an [LCD screen](https://www.waveshare.com/1.69inch-lcd-module.htm) for the Pi. This gives you a quick way of checking that your node is functional. The LCD screen is included in the WelcomeBox.
 
 ---
diff --git a/docs/setup/single-mode/hardware-assembly.md b/docs/setup/single-mode/hardware-assembly.md
@@ -44,7 +44,7 @@ Place the thermal pads on the CPU, RP1, RAM and PMIC Chip of the RPi 5.
 
 There are different versions of this case on the market:
 * If you have four thermal pads, place them in the areas marked in blue.
-* If you have two thermal pads in the set, place them on the CPU and PMIC (bottom left corner, near the USB-C connector).
+* If you have two thermal pads in the set, place them on the CPU and PMIC (left corner, near the USB-C connector).
 
 ![Thermal pad placement diagram](../img/assembly/thermal.png)
 
diff --git a/docs/setup/single-mode/hardware-checklist.md b/docs/setup/single-mode/hardware-checklist.md
@@ -14,7 +14,7 @@ You can run a single device node on any of the following.
 
 - Raspberry Pi 4 - [see full details](#raspberry-pi-4)
 
-- Raspberry Pi CM4 - [see ful details](#raspberry-pi-cm4)
+- Raspberry Pi CM4/5 - [see ful details](#raspberry-pi-compute-module)
 
 Optionally, you can add an [LCD display](../../monitoring/lcd.md) for monitoring purposes.
 
@@ -25,7 +25,7 @@ Optionally, you can add an [LCD display](../../monitoring/lcd.md) for monitoring
 - 1 X [SD Card reader/writer](./hardware-recommendations.md#sd-card-reader-and-writer)
 - 1 x [microSD Card](./hardware-recommendations.md#microsd-card)
 - 1 x [Power supply](https://botland.store/raspberry-pi-5-power-supply/23907-raspberry-pi-27w-usb-c-power-supply-official-51v-5a-psu-for-raspberry-pi-5-black-5056561803418.html)
-- 1 X [Raspberry Pi 5 Active Cooler]([Raspberry Pi Active Cooler - heatsink + fan for Raspberry Pi 5 Botland - Robotic Shop](https://botland.store/raspberry-pi-5-mounting-elements/23925-raspberry-pi-active-cooler-heatsink-fan-for-raspberry-pi-5-5056561803357.html)
+- 1 x [Raspberry Pi 5 Active Cooler](https://botland.store/raspberry-pi-5-mounting-elements/23925-raspberry-pi-active-cooler-heatsink-fan-for-raspberry-pi-5-5056561803357.html)
 
 ### Raspberry Pi 4
 
@@ -36,20 +36,20 @@ Optionally, you can add an [LCD display](../../monitoring/lcd.md) for monitoring
 - 1 X [Raspberry Pi 4 Active Cooler](https://botland.store/raspberry-pi-4b-cases/15106-case-justpi-for-raspberry-pi-4b-aluminum-with-dual-fan-black-lt-4b02-5903351242660.html)
 - 1 x [Power supply](https://botland.store/raspberry-pi-4b-power-supply/14348-power-supply-for-raspberry-pi-4-usb-c-51v-3a-original-black-644824914886.html)
 
-### Raspberry Pi CM4
+### Raspberry Pi Compute Module
 
-The CM4 module needs a carrier board. There are many on the market.
+The CM4/5 module needs a carrier board. There are many on the market.
 
 Minimum requiments are:
 
-- 1 x [Raspberry Pi CM4 (8GB)](https://botland.store/raspberry-pi-cm/18211-raspberry-pi-cm4-compute-module-4-8gb-ram-32gb-emmc-wifibluetooth-cm4108032-5904422368593.html)
+- 1 x Raspberry Pi CM4/CM5 8GB
 - 1 x [2TB fast storage](./hardware-recommendations.md#ssd-drive)
 - 1 x Power supply
-- 1 X [Raspberry Pi CM4 Active Cooler]((https://botland.store/raspberry-pi-cm/21716-dedicated-all-in-one-3007-cooling-fan-for-raspberry-pi-cm4-waveshare-22096.htm)
-- 32GB+ storage for operating system (microSD or eMMC)
-- 1 X Motherboard
+- 1 x Raspberry Pi CM4 Active Cooler
+- 1 x 32GB+ storage for operating system (microSD or eMMC)
+- 1 x Motherboard
 
-Installing Web3 Pi on the CM4 requires more knowledge. CM4 modules come with built-in eMMC memory, and in this case, you need to use the **rpiboot** application before using the Raspberry Pi Imager. If your module does not have built-in memory and uses an SD card, the installation process is similar to a standard Raspberry Pi.
+Installing Web3 Pi on the CM4/5 requires more knowledge. CM4/5 modules come with built-in eMMC memory, and in this case, you need to use the **rpiboot** application before using the Raspberry Pi Imager. If your module does not have built-in memory and uses an SD card, the installation process is similar to a standard Raspberry Pi.
 
 More information can be found on the manufacturer's website: [Raspberry Pi Documentation](https://www.raspberrypi.com/documentation/computers/compute-module.html).
 
diff --git a/docs/setup/single-mode/hardware-recommendations.md b/docs/setup/single-mode/hardware-recommendations.md
@@ -30,7 +30,7 @@ You can also use a USB to SATA adapter plus SSD 2.5" drive.
 
 | Brand   | Storage | Model          | Link\*                                                                                   | Comment                                                              |
 | ------- | ------- | -------------- | ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
-| Samsung | 2 TB    | T7 2TB USB 3.2 | https://tweakers.net/pricewatch/1560668/samsung-portable-ssd-t7-2tb-grijs/specificaties/ | **Recommended for most users. Compatible with Raspberry Pi 4 and 4** |
+| Samsung | 2 TB    | T7 2TB USB 3.2 | https://tweakers.net/pricewatch/1560668/samsung-portable-ssd-t7-2tb-grijs/specificaties/ | **Recommended for most users. Compatible with Raspberry Pi 4 and 5** |
 
 **Tip:** Some external disks consume more power than Raspberry Pi can deliver via USB. For Raspberry Pi 5, the max power output of the USB ports is 600mA if you're using a 3A supply, and1600mA if you're using a 5A supply. You can edit `/boot/firmware/config.txt` and add `usb_max_current_enable=1` to disable the current limit. Please read the documentation:
 
@@ -82,7 +82,7 @@ We do not recommend the following:
 | Brand   | Link\*                                                                                               |
 | ------- | ---------------------------------------------------------------------------------------------------- |
 | ZenWire | https://zenwire.eu/pl/p/Adapter-SSD-M2-NVMESATA-kieszen-na-dysk-obudowa-M.2-USB-C-10-GBs-Zenwire/289 |
-| RIITOP  | https://www.amazon.nl/dp/B0B1HVGBZ3?ref_=pe_28126711_487767311_302_E_DDE_dt_1                        |
+| RIITOP  | https://www.amazon.nl/dp/B0B1HVGBZ3                                                                  |
 | QOLTEC  | https://www.tme.eu/en/details/qoltec-50311/hdd-ssd-accessories/qoltec/50311/                         |
 
 or other similar.
diff --git a/docs/setup/single-mode/installation-monitoring.md b/docs/setup/single-mode/installation-monitoring.md
@@ -121,7 +121,7 @@ To check that the network is working correctly, SSH into the Rasberry Pi and run
 ping -c 4 google.com
 ```
 
-You should see the following response:
+You should see similar response:
 
 ```shell
 PING google.com (142.250.186.206) 56(84) bytes of data.
diff --git a/docs/setup/single-mode/software-setup.md b/docs/setup/single-mode/software-setup.md
@@ -31,7 +31,7 @@ For Single Mode device, the following settings can be configured:
 
 ## Advanced Options
 
-If you click the Advanced button, you can configure these additional options:
+If you click the **ADVANCED** button, you can configure these additional options:
 
 * **Execution endpoint address:** Optional custom endpoint for execution client
 * **Locale settings:** Including:
@@ -50,7 +50,7 @@ If you click the Advanced button, you can configure these additional options:
 
 ## Drive Selection
 
-After setting up the configuration and clicking "Next", a dialog box will appear allowing you to select the drive where the image with settings will be saved.
+After setting up the configuration and clicking **NEXT**, a dialog box will appear allowing you to select the drive where the image with settings will be saved.
 
 * **Drive selection:** The list shows available storage devices
 * **Display options:**
@@ -95,4 +95,4 @@ Now after the card has finished writing you will see a screen informing you abou
 
 ![Final screen](../img/single/w3p-inserting.png){ width=700px }
 
-Stop Web3 Pi Imager at this step and now we will start assembling the device. We will come back to this step after we finish assembling.
+Keep Web3 Pi Imager open at this step and now we will start assembling the device. We will come back to this step after we finish assembling.
