Skip to content

docs: secure boot, image descriptions and keyboard layout clarification #282

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

Merged
merged 2 commits into from
Nov 27, 2025
Merged

docs: secure boot, image descriptions and keyboard layout clarification #282

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9f69c82
docs: secure boot, image descriptions and keyboard layout clarification
NotaInutilis Nov 20, 2025
4cc9015
docs: more explicit keyboard layout
Zeglius Nov 27, 2025
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
13 changes: 10 additions & 3 deletions src/General/Installation_Guide/secure_boot.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ tags:
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2742", "fetched_at": "2024-09-03 16:43:23.922705+00:00"}-->
<!-- ANCHOR_END: METADATA -->

![Secure Boot|690x378, 50%](../../img/Secure_Boot.jpeg)
![Secure Boot menu: Continue boot / Enroll MOK / Enroll key from disk / Enroll hash from disk|690x378, 50%](../../img/Secure_Boot.jpeg 'Secure Boot')

## Secure Boot Notes and Gotchas

Expand All @@ -19,7 +19,7 @@ tags:

!!! important

Certain keyboard layouts can interfere with the characters of the password.
The enrollment prompt uses a QWERTY keyboard layout, indiscriminately of your actual hardware keyboard. Other layouts can therefore interfere with the characters of the password (i.e. `A` and `Q` are swapped on AZERTY layouts).

- Entering the password will register invisible characters for security purposes, so you will not be able to see what you are typing!

Expand All @@ -29,7 +29,14 @@ tags:

### Error message if key is **not** enrolled properly:

![load the kernel first error|613x63](../../img/load_the_kernel_first_error.jpeg)
```
error: ../../grub-core/kern/efi/sb.c:182:bad shim signature.
error: ../../grub-core/loader/1389/efi/linux.c:256:you need to load the kernel first.

Press any key to continue...
```

![error: ../../grub-core/kern/efi/sb.c:182:bad shim signature. / error: ../../grub-core/loader/1389/efi/linux.c:256:you need to load the kernel first. / Press any key to continue...|613x63](../../img/load_the_kernel_first_error.jpeg 'load the kernel first error')
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot Nov 20, 2025

Choose a reason for hiding this comment

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

medium

While the descriptive alt text is good for accessibility, it's now redundant because the full error message is present in the code block just above. For users with screen readers, this means the long error message will be read out twice. To improve their experience, it's better to use a more concise alt text that describes the image's purpose, such as indicating it's a screenshot of the error mentioned above.

Suggested change
![error: ../../grub-core/kern/efi/sb.c:182:bad shim signature. / error: ../../grub-core/loader/1389/efi/linux.c:256:you need to load the kernel first. / Press any key to continue...|613x63](../../img/load_the_kernel_first_error.jpeg 'load the kernel first error')
![Screenshot of the secure boot error message shown above.|613x63](../../img/load_the_kernel_first_error.jpeg 'load the kernel first error')


Follow **Method B** below to resolve this and move past the error message if you encounter it.

Expand Down