doc: final streamlining of README files

Now, the README are the entry into the repository and guide the user to the
actual documentation in lib.rs respectively on docs.rs.

Author: phip1611

README.md

@@ -13,54 +13,30 @@ Rusty wrapper for the [Unified Extensible Firmware Interface][UEFI].
 Develop Rust software that leverages **safe**, **convenient**, and
 **performant** abstractions for [UEFI] functionality.
 
-## Description
+## API and User Documentation
 
-Our mission is to provide **safe** and **performant** wrappers for UEFI
-interfaces, and allow developers to write idiomatic Rust code.
+The main contribution of this project is the `uefi` crate.
+Please refer to [docs.rs](https://docs.rs/uefi) for comprehensive documentation
+of the **latest stable release**. The latest not necessarily yet published
+documentation can be found in [`src/lib.rs`], which can also be locally build by
+running `$ cargo xtask doc --open`.
+
+## Repository Structure
 
 This repository provides various crates:
 
-- `uefi-raw`: Raw Rust UEFI bindings for basic structures and functions.
-- `uefi`: High-level wrapper around various low-level UEFI APIs. \
+- [`uefi-raw`](/uefi-raw/README.md): Raw Rust UEFI bindings for basic structures and functions.
+- [`uefi`](/uefi/README.md): High-level wrapper around various low-level UEFI APIs. \
   Offers various optional features for typical Rust convenience, such as a
   Logger and an Allocator. (_This is what you are usually looking for!_)
-- `uefi-macros`: Helper macros. Used by `uefi`.
-
-
-You can use the abstractions for example to:
-
-- create OS-specific loaders and leverage UEFI boot service
-- access UEFI runtime services from an OS
+  This is the **main contribution** of this project.
+- [`uefi-macros`](/uefi-macros/README.md): Helper macros used by `uefi` .
 
-[UEFI]: https://en.wikipedia.org/wiki/Unified_Extensible_Firmware_Interface
 
 ![UEFI App running in QEMU](https://imgur.com/SFPSVuO.png)
 Screenshot of an application running in QEMU on an UEFI firmware that leverages
 our Rust library.
 
-## User Documentation
-
-<!-- KEEP IN SYNC WITH uefi/README -->
-
-For a quick start, please check out [the UEFI application template](template).
-
-The [uefi-rs book] contains a tutorial, how-tos, and overviews of some important
-UEFI concepts. Reference documentation for the various crates can be found on
-[docs.rs]:
-
-- [docs.rs/uefi](https://docs.rs/uefi)
-- [docs.rs/uefi-macros](https://docs.rs/uefi-macros)
-- [docs.rs/uefi-raw](https://docs.rs/uefi-raw)
-
-For additional information, refer to the [UEFI specification][spec].
-
-[spec]: https://uefi.org/specs/UEFI/2.10
-[uefi-rs book]: https://rust-osdev.github.io/uefi-rs/HEAD
-[docs.rs]: https://docs.rs
-
-### MSRV
-
-See the [uefi package's README](uefi/README.md#MSRV).
 
 ## Developer Guide
 
@@ -118,14 +94,11 @@ most of the library's functionality.
 Check out the testing project's [`README.md`](uefi-test-runner/README.md) for
 prerequisites for running the tests.
 
-# Discuss and Contribute
-
-For general discussions, feel free to join us in our [Zulip] and ask
-your questions there.
+## Contributing
 
-Further, you can submit bugs and also ask questions in our [issue tracker].
-Contributions in form of a PR are also highly welcome. Check our
-[contributing guide](./CONTRIBUTING.md) for details.
+We welcome issues and pull requests! For instructions on how to set up a
+development environment and how to add new protocols, check out
+[CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## License
 
@@ -136,4 +109,5 @@ modifications to the files must be open-sourced.
 The full text of the license is available in the [license file](LICENSE).
 
 
-[Zulip]: https://rust-osdev.zulipchat.com
+
+[UEFI]: https://en.wikipedia.org/wiki/Unified_Extensible_Firmware_Interface

uefi/README.md

@@ -25,26 +25,12 @@ gated behind an `unstable` Cargo feature flag.
 _Note that for producing EFI 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].
+## Documentation
 
-[README]: https://github.com/rust-osdev/uefi-rs/blob/main/README.md
+Please refer to [docs.rs](https://docs.rs/uefi) for comprehensive documentation
+of the **latest stable release**. The latest not necessarily yet published
+documentation can be found in [`src/lib.rs`], which can also be locally build by
+running `$ cargo xtask doc --open`.
 
-## Optional features
-
-This crate's features are described in [`src/lib.rs`].
-
-[`src/lib.rs`]: src/lib.rs
-
-## MSRV
-
-The minimum supported Rust version is currently 1.70.
-
-Our policy is to support at least the past two stable releases.
-
-## License
-
-The code in this repository is licensed under the Mozilla Public License 2.
-This license allows you to use the crate in proprietary programs, but any modifications to the files must be open-sourced.
-
-The full text of the license is available in the [license file](LICENSE).
+For an introduction to the `uefi-rs` project and this repository, please refer
+to our main [README](https://github.com/rust-osdev/uefi-rs/blob/main/README.md).