doc: move background info to lib.rs

This is the beginning of moving all relevant information from README.md to lib.rs.
The main idea is to have `lib.rs` as main entry point into the documentation instead
of an inconsistent mixture between the README and the lib.rs file.

Author: phip1611

README.md

@@ -15,14 +15,6 @@ Develop Rust software that leverages **safe**, **convenient**, and
 
 ## Description
 
-[UEFI] started as the successor firmware to the BIOS in x86 space and developed
-to a universal firmware specification for various platforms, such as ARM. It
-provides an early boot environment with a variety of [specified][spec]
-ready-to-use "high-level" functionality, such as accessing disks or the network.
-EFI images, the files that can be loaded by an UEFI environment, can leverage
-these abstractions to extend the functionality in form of additional drivers,
-OS-specific bootloaders, or different kind of low-level applications.
-
 Our mission is to provide **safe** and **performant** wrappers for UEFI
 interfaces, and allow developers to write idiomatic Rust code.
 

uefi/src/lib.rs

@@ -83,6 +83,17 @@
 //! only unfold their potential when you invoke `uefi::helpers::init` as soon
 //! as possible in your application.
 //!
+//! # Trivia and Background
+//!
+//! [UEFI] started as the successor firmware to the BIOS in x86 space and
+//! developed to a universal firmware specification for various platforms, such
+//! as ARM. It provides an early boot environment with a variety of
+//! [specified][spec] ready-to-use "high-level" functionality, such as accessing
+//! disks or the network. EFI images, the files that can be loaded by an UEFI
+//! environment, can leverage these abstractions to extend the functionality in
+//! form of additional drivers, OS-specific bootloaders, or any different kind
+//! of low-level applications (such as an [IRC client][uefirc]).
+//!
 //! [Rust UEFI Book]: https://rust-osdev.github.io/uefi-rs/HEAD/
 //! [UEFI]: https://uefi.org/
 //! [`BootServices`]: table::boot::BootServices
@@ -93,6 +104,7 @@
 //! [issue tracker]: https://github.com/rust-osdev/uefi-rs/issues
 //! [spec]: https://uefi.org/specifications
 //! [unstable features]: https://doc.rust-lang.org/unstable-book/
+//! [uefirc]: https://github.com/codyd51/uefirc
 
 #![cfg_attr(all(feature = "unstable", feature = "alloc"), feature(allocator_api))]
 #![cfg_attr(docsrs, feature(doc_auto_cfg))]