doc: add rust-std chapter to book

Author: phip1611

book/src/SUMMARY.md

@@ -10,6 +10,7 @@
   - [Using Protocols](how_to/protocols.md)
   - [Drawing to the Screen](how_to/drawing.md)
   - [Building drivers](how_to/building_drivers.md)
+  - [Combining Rust `std` with `uefi`](how_to/rust-std.md)
 - [Concepts](concepts/introduction.md)
   - [Boot Stages](concepts/boot_stages.md)
   - [Tables](concepts/tables.md)

book/src/how_to/rust-std.md

@@ -0,0 +1,29 @@
+# Combining Rust `std` with `uefi`
+
+## TL;DR
+
+In Mid-2024, we recommend to stick to our normal guide. Use this document as
+guide and outlook for the future of UEFI and Rust.
+
+## About
+
+In the `uefi` crate, we provide tooling to create a `no_std` + `no_main`
+binary, i.e., an UEFI image, in a convenient way by providing a `#[entry]`
+macro for the crate's main function. However, after ongoing efforts in upstream
+Rust, there is also the option to create a "standard" binary for UEFI. The
+result is the same, but the build process and the overall programming experience
+is much more similar to regular Rust applications written for Operating Systems,
+such as Linux, Windows, or macOS.
+
+The `uefi` crate is suited to extend the functionality of these "standard
+binaries". Note that UEFI in `std` is work-in-progress, and some functionality
+only works with nightly toolchains.
+
+## Code Example
+
+Please refer to [`<repo>/uefi-std-example`](/uefi-std-example/README.md) to
+see a specific example. The relevant `main.rs` looks as follows:
+
+```rust
+{{#include ../../../uefi-std-example/src/main.rs}}
+```