doc: streamline About section and rename to "Value-add"

uefi/README.md

@@ -11,6 +11,17 @@ This crate makes it easy to develop Rust software that leverages **safe**,
 ![Build status](https://github.com/rust-osdev/uefi-rs/workflows/Rust/badge.svg)
 ![Stars](https://img.shields.io/github/stars/rust-osdev/uefi-rs)
 
+## Value-add and Use Cases
+
+`uefi` supports writing code for both pre- and post-exit boot services
+epochs, but its true strength shines when you create UEFI images that heavily
+interact with UEFI boot services. Still, you have the flexibility to just
+integrate selected types and abstractions into your project, for example to
+parse the UEFI memory map.
+
+_Note that for producing UEFI images, you also need to use a corresponding
+`uefi` compiler target of Rust, such as `x86_64-unknown-uefi`._
+
 For an introduction to the `uefi-rs` project and documentation, please refer to
 our main [README].
 

uefi/src/lib.rs

@@ -7,11 +7,30 @@
 //! important UEFI concepts. For more details of UEFI, see the latest [UEFI
 //! Specification][spec].
 //!
-//! # Interaction with uefi services
-//!
-//! With this crate you can write code for the pre- and post-exit boot services
-//! epochs. However, the `uefi` crate unfolds its true potential when
-//! interacting with UEFI boot services.
+//! # Value-add and Use Cases
+//!
+//! `uefi` supports writing code for both pre- and post-exit boot services
+//! epochs, but its true strength shines when you create UEFI images that heavily
+//! interact with UEFI boot services. Still, you have the flexibility to just
+//! integrate selected types and abstractions into your project, for example to
+//! parse the UEFI memory map.
+//!
+//! _Note that for producing UEFI images, you also need to use a corresponding
+//! `uefi` compiler target of Rust, such as `x86_64-unknown-uefi`._
+//!
+//! ## Example Use Cases
+//!
+//! This library significantly simplifies the process of creating **UEFI images**
+//! by abstracting away much of the UEFI API complexity and by providing
+//! convenient wrappers. When we mention UEFI images, we are talking about UEFI
+//! applications, UEFI boot service drivers, and EFI runtime service drivers,
+//! which typically have the `.efi` file extension. For instance, an UEFI
+//! application could be an OS-specific loader, similar to _GRUB_ or _Limine_.
+//!
+//! Additionally, you can use this crate in non-UEFI images (such as a kernel
+//! in ELF format) to perform tasks like parsing the UEFI memory map embedded in
+//! the boot information provided by a bootloader. It also enables access to
+//! UEFI runtime services from a non-UEFI image kernel.
 //!
 //! # Supported Architectures
 //!