Skip to content

Rework the introduction #78

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

Open
orangecms wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Rework the introduction #78

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
41 changes: 22 additions & 19 deletions content/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,29 +1,32 @@
LinuxBoot is the concept of using a Linux kernel and initramfs as a bootloader.
LinuxBoot is the concept of [using a Linux kernel and initramfs as a
bootloader](#benefits).
Copy link
Contributor

@pamolloy pamolloy Nov 28, 2025

Choose a reason for hiding this comment

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

The link text doesn't match the link. Benefits of something are not equal to that thing. Anyway, the benefits section is only a few sentences away so no need to link to it.


![](images/linuxboot_info.png)

The official documentation for LinuxBoot is the [LinuxBoot Book 📖](https://book.linuxboot.org),
where you can find information on how LinuxBoot works and implementing it with
various approaches, such as based on coreboot or UEFI PEI.
Copy link
Contributor

@pamolloy pamolloy Nov 28, 2025

Choose a reason for hiding this comment

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

"Implementing it with various approaches" would be how you configure the kernel or what you use for userspace. coreboot and UEFI PEI are two examples of loaders of LinuxBoot, not strictly examples of implementation approaches, although they can impact the implementation. I'd also either remove the explicit examples or at least add U-Boot SPL. This is just two of the 4 examples already in linuxboot_info.png.


The [`linuxboot`](https://github.com/linuxboot/linuxboot) repository contains a
build system implementing LinuxBoot primarily targeting servers and PCs, which
started as [*NERF*](https://trmm.net/NERF) in January 2017 at Google.
reference build system implementing LinuxBoot primarily targeting servers and
PCs, which started as [*NERF*](https://trmm.net/NERF) in January 2017 at Google.

![](images/linuxboot_info.png)
We encourage [participation](#organization) to keep up to date and find a
suitable solution for a specific use case.

## Why?
## Benefits

* Improves boot reliability by replacing lightly-tested firmware drivers with
hardened Linux drivers.
* Improves boot time by removing unnecessary code. Typically makes boot 20
times faster.
* Allows customization of the initrd runtime to support site-specific needs
(both device drivers as well as custom executables).
* Proven approach for almost 20 years in military, consumer electronics, and
supercomputing systems -- wherever reliability and performance are
paramount.
Linux is the proven approach for almost 20 years in military, consumer
electronics, and supercomputing systems - wherever reliability and performance
are paramount.

## LinuxBoot Book 📖
As a bootloader environment, it offers

The official documentation for LinuxBoot is the [LinuxBoot Book](https://book.linuxboot.org),
where you can find information on how LinuxBoot works, how to build the various
flavours (e.g. coreboot/LinuxBoot or UEFI PEI/LinuxBoot), the
[u-root](https://github.com/u-root/u-root) ramfs builder, etc.
* Steadfast reliability through bespoke and well-tested drivers
* Improved boot time by excluding unnecessary code, typically 20 times faster
than other solutions
* Runtime customization to support site-specific needs, covering both device
drivers as well as executables
Copy link
Contributor

@pamolloy pamolloy Nov 28, 2025

Choose a reason for hiding this comment

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

I'd personally just move this to the book and mention that in the sentence about the book above.


## Organization

Expand Down