Update OS installation instructions from iso testing expectations - #225
Merged
tlaurion merged 7 commits intoAug 19, 2026
Merged
Conversation
There was a problem hiding this comment.
Pull request overview
Updates the OS installation documentation to align with current Heads ISO testing expectations, especially around the requirement for an unencrypted /boot and distro-specific installation guidance.
Changes:
- Clarifies why Heads requires a separate, unencrypted
/bootand provides a recommended manual partitioning layout. - Adds/updates distro-specific notes (Debian, Fedora, Qubes, NixOS, PureOS) and refreshes the “last tested ISO” list.
- Links to an external ISO test matrix intended to track tested images.
Suppressed comments (1)
Installing-and-Configuring/install-os.md:95
- For consistency with the rest of this document’s Setext heading style, consider switching this
##heading to a Setext subheading.
## Distro notes
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
…y compatibility notes Signed-off-by: Thierry Laurion <insurgo@riseup.net>
…fix test matrix link Signed-off-by: Thierry Laurion <insurgo@riseup.net>
…at final path Signed-off-by: Thierry Laurion <insurgo@riseup.net>
- Convert 30 bare leading-slash internal links to {{ site.baseurl }}/<permalink> so they resolve under the /heads-wiki/ subdirectory
- Point the Recovery Shell link in About/Keys.md at the correct /RecoveryShell/ permalink
- Collapse a doubled site.baseurl in Flashing-Guides/T430-maximized.md
- Retarget the Makefiles link in Development/Porting.md from a raw .md path to the /Makefile/ permalink
Signed-off-by: Thierry Laurion <insurgo@riseup.net>
- Prefix two bare /Heads-threat-model/ links in RecoveryShell.md with site.baseurl - Retarget the EOL and programmer-selection anchors in the board guides to their actual headings - Point the make-details supported-devices link at the Prerequisites page - Fix a malformed markdown link in the p8z77 building guide - Remove the dangling flashing-guide reference from the p8z77 building guide (board is unmaintained) Signed-off-by: Thierry Laurion <insurgo@riseup.net>
…md: remove unmaintained board guide - Remove the p8z77-m_pro building guide; the board is unmaintained (upstream: unmaintained_boards/) Signed-off-by: Thierry Laurion <insurgo@riseup.net>
tlaurion
force-pushed
the
fix-215-update-os-install-docs
branch
from
August 19, 2026 20:11
17618c0 to
4bb3078
Compare
- Correct the TPM GPIO Reset status of NovaCustom NV4x ADL and NitroPad NS50 from INCONCLUSIVE to VULNERABLE (confirmed; NS50 shares the same PCH 0x5182) Signed-off-by: Thierry Laurion <insurgo@riseup.net>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #215
Depends on: linuxboot/heads#2186 (must merge first; it moves the ISO boot test suite to tests/iso-test/, which this PR links to).
Changes
/InstallingOS/) previously resolved to the domain root instead of the/heads-wiki/subdirectory; all are now prefixed with{{ site.baseurl }}. Also fixed dangling anchors in the board guides and other broken/raw markdown links.master, bringing in the uniformization of the 20 board pages (shared template, alphabeticalnav_order). All flashing guides now follow the same EOL / TPM-GPIO-reset / Safety-First callout pattern.unmaintained_boards/upstream).