moved dev environment stuff, fixed a lot of broken links

Author: gonzolively

.lycheeignore

@@ -11,4 +11,9 @@
 # Example:
 # https://example.com/specific-page
 # *.example.com/*
+
+# Ignore localhost
 http://localhost:4000/
+
+# For some reason st times out on all pages. Will need to fix this in the future
+https://www.st.com

docs/board-support/ST/B-U585I-IOT02A/index.md

@@ -54,7 +54,7 @@ The device will appear as a USB serial port when properly connected. On Linux/ma
 
 ## Flashing the Firmware
 
-To flash the Ocre runtime, please follow the steps in the [Using a Physical Device](../../../quickstart/firmware/hardware) section found in the [Building and Flashing the Ocre Runtime](../../../quickstart/firmware/index) guide. 
+To flash the Ocre runtime, please follow the steps in the [Using a Physical Device](../../../quickstart/firmware/hardware) section found in the [Building and Flashing the Ocre Runtime](../../../quickstart/firmware) guide. 
 
 {: .note}
 Be sure to use `b_u585i_iot02a` as your board name.

docs/board-support/ST/NUCLEO-H723ZG/index.md

@@ -56,7 +56,7 @@ The device will appear as a USB serial port when properly connected. On Linux/ma
 
 ## Flashing the Firmware
 
-To flash the Ocre runtime, please follow the steps in the [Using a Physical Device](../../../quickstart/firmware/hardware) section found in the [Building and Flashing the Ocre Runtime](../../../quickstart/firmware/index) guide. 
+To flash the Ocre runtime, please follow the steps in the [Using a Physical Device](../../../quickstart/firmware/hardware) section found in the [Building and Flashing the Ocre Runtime](../../../quickstart/firmware) guide. 
 
 {: .note}
 Be sure to use `nucleo_h723zg` as your board name.

docs/board-support/index.md

@@ -16,5 +16,5 @@ The Ocre runtime supports various development boards, each offering different fe
 Select your boards manufacturer in the **sidebar** to the left, and subsequently your specific board for detailed setup and usage instructions for your board.
 
 ## Adding Board Support
-If your board isn't listed in our supported devices, check out the [Adding Board Support](../board-support/adding-support/index) guide in the sidebar. This guide walks you through the process of adding support for new development boards to the Ocre runtime.
+If your board isn't listed in our supported devices, check out the [Adding Board Support](../board-support/adding-support) guide in the sidebar. This guide walks you through the process of adding support for new development boards to the Ocre runtime.
 I've:

docs/quickstart/firmware/hardware.md

@@ -9,7 +9,7 @@ nav_order: 1
 
 This guide covers building and flashing the Ocre runtime onto actual development boards. While simulated environments are great for initial testing, deploying to real hardware allows you to test your applications under authentic conditions and take advantage of board-specific features like sensors and networking capabilities.
 
-Please refer to the board-specific documentation in our [Board Support](../../../board-support) section for detailed setup instructions and requirements for your board before attempting to flash Ocre.
+Please refer to the board-specific documentation in our [Board Support](../../board-support) section for detailed setup instructions and requirements for your board before attempting to flash Ocre.
 
 ---
 
@@ -20,7 +20,7 @@ Please refer to the board-specific documentation in our [Board Support](../../..
 Complete the [Install dependencies](https://docs.zephyrproject.org/3.7.0/develop/getting_started/index.html#install-dependencies) and the [Install the Zephyr SDK](https://docs.zephyrproject.org/3.7.0/develop/getting_started/index.html#install-the-zephyr-sdk) sections for your host operating system from the Zephyr (v3.7.0) [Getting Started Guide](https://docs.zephyrproject.org/3.7.0/develop/getting_started/index.html#getting-started-guide). 
 
 {: .note}
-Currently the Ocre runtime is built on Zephyr `3.7.0`. As a result, the links in the above section reference `v3.7.0` documentation and not the *latest* documentation. It is advised to follow the links in this guide to ensure compability with your device.
+Currently the Ocre runtime is built on Zephyr `3.7.0`. As a result, the links in the above section reference `v3.7.0` documentation and not the *latest* documentation. It is advised to follow the links in this guide to ensure compatibility with your device.
 
 ### **2. Install WEST**
 
@@ -37,7 +37,7 @@ We recommend using a Python virtual environment like [venv](https://docs.python.
 
 Next, we will prepare the Zephyr workspace and checkout the project code.
 
-First, create the `runtime` directory in the location of your chosing.
+First, create the `runtime` directory in the location of your choosing.
 ```
 mkdir runtime
 ```
@@ -94,4 +94,4 @@ After flashing, restart/reset your board to run the application.
 ## Troubleshooting
 This section covers common issues you might encounter when building and flashing the Ocre runtime to physical hardware, along with their solutions.
 
-- **Unsupported Board**: If you're unable to flash to your board, and it's not listed in our [supported boards](../../../board-support), check out our [Adding Board Support](../../../board-support/adding-support) guide under the Board Support section. This guide will walk you through the process of adding support for your specific hardware. 
+- **Unsupported Board**: If you're unable to flash to your board, and it's not listed in our [supported boards](../../board-support), check out our [Adding Board Support](../../board-support/adding-support) guide under the Board Support section. This guide will walk you through the process of adding support for your specific hardware. 

docs/quickstart/firmware/simulated.md

@@ -16,7 +16,7 @@ This guide covers building and running the Ocre runtime using Zephyr's `native_s
 > 2. The POSIX architecture does not work on macOS due to fundamental differences between macOS and other Unix-like operating systems.
 > 
 > For users affected by these limitations, we recommend using one of the following alternatives:
-> - A Linux-based x86_64 development container. (Feel free to use the [Ocre Dev Container](../../prerequisites/dev-environment/index) you obtained when setting up your dev environment.)
+> - A Linux-based x86_64 development container. (Feel free to use the [Ocre Dev Container](../first-app/dev-environment) you obtained when setting up your dev environment.)
 > - A computer with a x86_64 architecture 
 > - Emulating a Linux-based VM with x86_64 architecture
 
@@ -29,7 +29,7 @@ This guide covers building and running the Ocre runtime using Zephyr's `native_s
 Complete the [Install dependencies](https://docs.zephyrproject.org/3.7.0/develop/getting_started/index.html#install-dependencies) and the [Install the Zephyr SDK](https://docs.zephyrproject.org/3.7.0/develop/getting_started/index.html#install-the-zephyr-sdk) sections for your host operating system from the Zephyr (v3.7.0) [Getting Started Guide](https://docs.zephyrproject.org/3.7.0/develop/getting_started/index.html#getting-started-guide). 
 
 {: .note}
-Currently the Ocre runtime is built on Zephyr `3.7.0`. As a result, the links in the above section reference `v3.7.0` documentation and not the *latest* documentation. It is advised to follow the links in this guide to ensure compability with your device.
+Currently the Ocre runtime is built on Zephyr `3.7.0`. As a result, the links in the above section reference `v3.7.0` documentation and not the *latest* documentation. It is advised to follow the links in this guide to ensure compatibility with your device.
 
 ### **2. Install WEST**
 
@@ -46,7 +46,7 @@ We recommend using a Python virtual environment like [venv](https://docs.python.
 
 Next, we will prepare the Zephyr workspace and checkout the project code.
 
-First, create the `runtime` directory in the location of your chosing.
+First, create the `runtime` directory in the location of your choosing.
 ```
 mkdir runtime
 ```

…t/prerequisites/dev-environment/index.md …start/first-app/dev-environment/index.mddocs/quickstart/prerequisites/dev-environment/index.md renamed to docs/quickstart/first-app/dev-environment/index.md docs/quickstart/prerequisites/dev-environment/index.md renamed to docs/quickstart/first-app/dev-environment/index.md

@@ -1,9 +1,8 @@
 ---
 title: Setting Up Your Development Environment 
 layout: default
-parent: Prerequisites 
-nav_order: 1
-has_toc: true
+parent: Your First App 
+nav_order: 0
 ---
 
 # Setting Up Your Development Environment

docs/quickstart/first-app/first-container/index.md

@@ -0,0 +1,6 @@
+---
+title: Creating Your First App 
+layout: default
+parent: Your First App 
+nav_order: 1
+---

docs/quickstart/first-app/index.md

@@ -4,4 +4,21 @@ layout: default
 parent: Quickstart
 nav_order: 3 
 has_children: true 
----
+---
+
+# Your First App
+
+This section guides you through creating your first containerized application with Ocre. You'll set up a development environment and build a simple application that demonstrates Ocre's core capabilities.
+
+---
+
+## Getting Started
+
+Begin by following our [Setting Up Your Development Environment](./dev-environment) guide to install and configure the necessary tools. This guide offers two approaches:
+- Using Visual Studio Code with Dev Containers for an integrated IDE experience
+- Using Docker interactively for a command-line workflow
+
+Once your environment is ready, proceed to [Creatig Your First App](./first-container) to create your first Ocre application.
+
+{: .note}
+While we recommend using our Docker-based development environment for consistency, experienced developers can also set up their own toolchain using the required components detailed in our documentation.

docs/quickstart/prerequisites/index.md

@@ -10,8 +10,7 @@ has_children: true
 
 What you’ll need to get started:
 1. A **Computer** running Windows, Mac or Linux with [Git](https://github.com/git-guides/install-git) and a [serial console](../prerequisites/serial-console) installed.
-2. **Development Board** (See the [supported boards](../../reference/board-support/index.md) list).
+2. **Development Board** (See the [supported boards](../../board-support) list).
 3. **USB Cable** for your development board.
-4. Set up your [development environment](../prerequisites/dev-environment).
 
-Once the prerequisites are complete, proceed to the [Building and Flashing the Ocre Runtime](../firmware/index.md) section to build and install the Ocre runtime.
+Once the prerequisites are complete, proceed to the [Building and Flashing the Ocre Runtime](../firmware) section to build and install the Ocre runtime.