docs: fix broken links

Author: f-hollow

content/blog/2025/05/debugging-with-vscode/index.md

@@ -181,7 +181,7 @@ OpenOCD uses a server-client model to debug embedded systems. The OpenOCD server
 Next, we'll start the openOCD server and test the connection with the hardware. The steps below are for an ESP32-C3 board, but you can easily adjust them for your module. We will use the JTAG over USB pins option. If you're using the ESP-PROG, modify steps 2 and 3 accordingly.
 
 1. Create a project from the `hello_world` example.   
-  _If you're unsure, please check [the documentation](https://docs.espressif.com/projects/vscode-esp-idf-extension/en/latest/startproject.html#esp-idf-show-examples-projects)_
+  _If you're unsure, please check [the documentation](https://docs.espressif.com/projects/vscode-esp-idf-extension/en/latest/startproject.html#using-esp-idf-new-project)_
 2. > `ESP-IDF: Select Port to Use (COM, tty, usbserial)` - Choose the port you're connected to. You may find the SoC name and package next to the correct option (e.g. ESP32-C3 (QFN32) (revision v0.3))
 3. >`ESP-IDF: Set Espressif Device target` → `esp32c3` →`ESP32-C3 chip (via Built-in USB-JTAG)`   
     ("`esp32c3`" should now appear at the bottom left corner)
@@ -261,4 +261,3 @@ If it's still not working, connect your board via UART0 pins (which in an develo
 ## Conclusion
 
 In this tutorial, you learned how to connect your Espressif module via JTAG and start the openOCD server. In part two, we'll launch `gdb` and explore the code using various commands.
-

content/blog/2025/05/news-esp32c5-mp/index.md

@@ -9,7 +9,7 @@ Espressif Systems (SSE: 688018.SH) announced ESP32-C5, the industry’s first RI
 
 ESP32-C5 is designed for applications that require high-efficiency, low-latency wireless transmission. ESP32-C5 has a 32-bit single-core processor which can clock up to 240 MHz in speed. It has a 384 KB on-chip SRAM along with external PSRAM support, 320 KB of ROM. It has up to 29 programmable GPIOs, supporting all the commonly used peripherals, high speed interfaces like SDIO, QSPI, and the best-in-class security features. The ESP32-C5 also includes an LP-CPU running upto 40MHz which can act as the main processor for power sensitive applications. To learn more about the various capabilities and features of this MCU, please visit our [website](https://www.espressif.com/en/products/socs/esp32-c5).
 
-The ESP32-C5 benefits from software support provided by Espressif's well-established IoT development framework, ESP-IDF. The upcoming ESP-IDF v5.5, will include initial support for the ESP32-C5. For a detailed list of ESP-IDF features supported for the ESP32-C5, click [here](../../../../pages/chip-support-status/esp32c5/). The ESP32-C5 can also act as the connectivity coprocessor for external hosts using the [ESP-AT](https://github.com/espressif/esp-at) or [ESP-Hosted](https://github.com/espressif/esp-hosted) solutions.
+The ESP32-C5 benefits from software support provided by Espressif's well-established IoT development framework, ESP-IDF. The upcoming ESP-IDF v5.5, will include initial support for the ESP32-C5. For a detailed list of ESP-IDF features supported for the ESP32-C5, click [here](../../../../hardware/esp32c5/). The ESP32-C5 can also act as the connectivity coprocessor for external hosts using the [ESP-AT](https://github.com/espressif/esp-at) or [ESP-Hosted](https://github.com/espressif/esp-hosted) solutions.
 
 ESP32-C5 development boards are now available for purchase at [Espressif's official stores](https://www.aliexpress.com/item/1005008790788462.html) If you are interested in the ESP32-C5 series products, please contact our [customer support team](https://www.espressif.com/en/contact-us/sales-questions).
 

content/blog/getting-started-with-wifi-on-esp-idf/index.md

@@ -404,7 +404,7 @@ esp_err_t tutorial_init(void)
 
 In particular, we can notice that the initialization step is similar to the previous example that uses `example_connect()`. Furthermore, there are additional initialization steps, such as defining the event loop, registering the event handler, and creating the network interface. The documentation for these additional steps can be found here:
 - [Event Loop Library](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-reference/system/esp_event.html#event-loop-library)
-- [Event Handler](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/event-handling.html#event-handling)
+- [Event Handler](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-reference/system/esp_event.html#event-loop-library)
 - [Netif (Network Interface)](https://docs.espressif.com/projects/esp-idf/en/v5.2.2/esp32/api-reference/network/esp_netif.html?highlight=netif_create_default#_CPPv433esp_netif_create_default_wifi_stav)
 
 In this tutorial, we also use Event Bits to indicate what Wi-Fi event has occurred. The details on Event Bits and Event Groups can be found [here](https://docs.espressif.com/projects/esp-idf/en/v5.2.2/esp32/api-reference/system/freertos_idf.html?highlight=eventgroup#_CPPv417xEventGroupCreatev).
@@ -468,7 +468,7 @@ We can also configure the hardware resources allocated for managing Wi-Fi. For i
 
 **Event Handler for Wi-FI and IP events**
 
-For this example, we created simple event handlers to log events related to [Wi-Fi](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-reference/network/esp_wifi.html?highlight=wifi_event#_CPPv412wifi_event_t) (defined under `wifi_event_t`) or [IP layer](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-reference/network/esp_netif.html?highlight=ip_event#_CPPv410ip_event_t) (defined under `ip_event_t`).
+For this example, we created simple event handlers to log events related to [Wi-Fi](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-reference/network/esp_wifi.html?highlight=wifi_event#_CPPv412wifi_event_t) (defined under `wifi_event_t`) or [IP layer](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-reference/network/esp_netif.html#ip-events) (defined under `ip_event_t`).
 
 The important notable events in establishing Wi-Fi are:
 - `WIFI_EVENT_STA_START` : The configuration for STA is completed

content/hardware/esp32c5/index.md

@@ -7,7 +7,7 @@ aliases:
 
 **Last updated:** {{< dynamic-block contentPath="persist/chip-support-status/esp32c5.json" jsonKey="timestamp" >}}
 
-The ESP32-C5-DevKitC-1-N8R4 development board is now [available for purchase](../../../blog/2025/05/news-esp32c5-mp/#where-to-buy).
+The ESP32-C5-DevKitC-1-N8R4 development board is now [available for purchase](../../blog/2025/05/news-esp32c5-mp/#where-to-buy).
 
 This page lists the projects in which the ESP32-C5 v1.0 is supported.
 

content/pages/contribution-guide/asciinema-casts/index.md

@@ -20,7 +20,7 @@ authors:
 
 ### Word of caution
 
-Use asciinema casts for output logs or to demonstrate things in action. Avoid using asciinema casts for interactive guides as many users [prefer](https://news.ycombinator.com/item?id=38137005) scrolling through commands and copying them from code snippets instead of fishing the commands out of an asciinema cast.
+Use asciinema casts for output logs or to demonstrate things in action. Avoid using asciinema casts for interactive guides as users in general prefer scrolling through commands and copying them from code snippets instead of fishing the commands out of an asciinema cast.
 
 
 ## Usage

content/workshops/esp-idf-basic/lecture-1/index.md

@@ -64,7 +64,7 @@ If you want to create and publish your own component, we recommend that you watc
 
 You can also find components by browsing our [ESP Registry](https://components.espressif.com) platform.
 
-In [assignment 3.2](assignment-3-2/), you will have a chance to create your own component and use it in your project.
+In [assignment 3.2](../assignment-3-2/), you will have a chance to create your own component and use it in your project.
 
 
 ### Frameworks