Book update

README.md

@@ -7,15 +7,15 @@ This book is a work in progress.
 This book is generated using [mdbook], and additionally uses the [mdbook-mermaid] preprocessor to add support for diagrams. To install these tools:
 
 ```shell
-$ cargo install mdbook mdbook-mermaid
+cargo install mdbook mdbook-mermaid
 ```
 
 With `mdbook` and `mdbook-mermaid` installed you can clone the respository and start a development server by running:
 
 ```shell
-$ git clone https://github.com/esp-rs/book
-$ cd book/
-$ mdbook serve
+git clone https://github.com/esp-rs/book
+cd book/
+mdbook serve
 ```
 
 [mdbook]: https://github.com/rust-lang/mdBook

src/SUMMARY.md

@@ -5,22 +5,25 @@
   - [Using the Standard Library (`std`)](./overview/using-the-standard-library.md)
   - [Bare Metal (`no_std`)](./overview/bare-metal.md)
   - [Comparing `std` and `no_std`](./overview/comparing-std-and-no_std.md)
-- [Required Dependencies](./dependencies/index.md)
-  - [Installing Rust](./dependencies/installing-rust.md)
-  - [Build Tools](./dependencies/build-tools.md)
-- [Tooling]()
+- [Installation](./installation/index.md)
+  - [Rust on Espressif SoCs](installation/rust-on-esp.md)
+  - [Installing Rust for Espressif SoCs](./installation/installing-rust-for-esp.md)
+- [Tooling](./tooling/index.md)
   - [Text Editors and IDEs](./tooling/text-editors-and-ides.md)
   - [espflash](./tooling/espflash.md)
   - [espmonitor](./tooling/espmonitor.md)
   - [Debugging]()
     - [probe-rs](./tooling/debugging/probe-rs.md)
     - [OpenOCD](./tooling/debugging/openocd.md)
     - [Debugging in Visual Studio Code](./tooling/debugging/vscode-debugging.md)
-- [Writing Your Application]()
-  - [Generate Project from Template](./writing-your-application/generate-project-from-template.md)
-  - [Writing `std` Applications](./writing-your-application/writing-std-applications.md)
+  - [Simulating](./tooling/simulating/index.md)
+    - [Wokwi](./tooling/simulating/wokwi.md)
+    - [QEMU](tooling/simulating/qemu.md)
+- [Writing Your Own Application](./writing-your-own-application/index.md)
+  - [Generate Project from Template](./writing-your-own-application/generate-project-from-template.md)
+  - [Writing `std` Applications](./writing-your-own-application/writing-std-applications.md)
   - [Writing `no_std` Applications (TODO)]()
-
+- [Resources](./resources.md)
 ---
 
 [Appendix A: Glossary](./misc/glossary.md)

src/installation/index.md

@@ -0,0 +1,27 @@
+# Installation
+
+With an understanding of the ecosystem surrounding Rust on Espressif chips, we can move on to actual development. If you are not aware of the two possible development approaches or do not understand the differences between writing `std` and `no_std` applications, please first read the [Ecosystem Overview] chapter.
+
+The dependencies required to build Rust applications for ESP Chips depend on the approach that we take.
+
+## `no_std` Applications
+
+- GCC Toolchain: GCC linker is used in our Rust applications.
+- Rust Toolchain: Used to compile our Rust code.
+  - `LLVM`: The Rust compiler uses `LLVM` as codegen backend.
+
+## `std` Applications
+
+- GCC Toolchain: GCC linker is used in our Rust applications.
+- Rust Toolchain: Used to compile our Rust code.
+  - `LLVM`: The Rust compiler uses `LLVM` as codegen backend.
+- [ESP-IDF]: Espressif IoT Development Framework.
+- [`ldproxy`] crate:  Simple tool to forward linker arguments given to [`ldproxy`] to the actual linker executable. The crate can be found in the [esp-rs/embuild] repository.
+
+This chapter, will cover how to properly install the correct Rust compiler and toolchain for our ESP chips.
+
+[Ecosystem Overview]: ../overview/index.md
+[ESP-IDF]: https://github.com/espressif/esp-idf
+[`std` overview]: src\overview\using-the-standard-library.md
+[`ldproxy`]: https://github.com/esp-rs/embuild/tree/master/ldproxy
+[esp-rs/embuild]: https://github.com/esp-rs/embuild