Skip to content

doc: massive overhaul of documentation #1264

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 13 commits into from
Closed

doc: massive overhaul of documentation #1264

Changes from 1 commit
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
79c048a
uefi: remove documentation about already removed feature
phip1611 Jul 28, 2024
676c585
doc: unified new TL;DR/description entry
phip1611 Jul 30, 2024
27ec946
doc: add "About this Document"
phip1611 Jul 30, 2024
d85b4c9
doc: move background info to lib.rs
phip1611 Jul 30, 2024
9f9e5ca
doc: streamline sections Contributing, MSRV, and License
phip1611 Jul 30, 2024
505e70f
doc: add "About" section
phip1611 Jul 30, 2024
e46e74a
doc: extend About section with Example Use Cases
phip1611 Jul 30, 2024
02bc2cf
doc: add Supported Architectures
phip1611 Jul 30, 2024
52954f4
doc: add "Comparison to other Projects in the Ecosystem"
phip1611 Jul 30, 2024
837fe5c
doc: add "API/User Documentation, Documentation Structure, and other …
phip1611 Jul 30, 2024
b9829d7
doc: Crate organization -> Library Structure & Tips
phip1611 Jul 30, 2024
e0fde84
doc: reorder links alphabetically in lib.rs
phip1611 Jul 30, 2024
5c9343f
doc: final streamlining of README files
phip1611 Jul 30, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions uefi/src/lib.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,13 @@
//! Feel free to file bug reports and questions in our [issue tracker], and [PR
//! contributions][contributing] are also welcome!
//!
//! # About this Document
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IMO this section isn't needed. Having some description at the front of a multi-page document can be helpful, but here it's pretty clear what all the content is by just scanning through the following sections on the page.

//!
//! In this document, you find general information about this crate, such
//! as examples and the technical documentation of the public API, as well
//! as general information about the project, such as license or MSRV
//! requirements.
//!
//! # Interaction with uefi services
//!
//! With this crate you can write code for the pre- and post-exit boot services
Expand Down