docs: fix broken links; correct Dasharo-board flashing guidance; drop -maximized for non-ME boards - #239
Conversation
There was a problem hiding this comment.
Pull request overview
This PR updates documentation across the Heads wiki to replace several external URLs that have become stale, addressing issue #232 by keeping hardware/security references and flashing guides current.
Changes:
- Updated multiple external references in threat model and flashing guides (coreboot, Binarly, community board docs, Dasharo/EC module).
- Refreshed Purism documentation links in flashing guides and key usage docs.
- Updated a Heads build example configuration link in developer documentation.
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| Installing-and-Configuring/Flashing-Guides/T440p-maximized.md | Updates the coreboot Intel FSP/MRC documentation link. |
| Installing-and-Configuring/Flashing-Guides/novacustom-v540tu-maximized.md | Updates EC-related module link for Dasharo-based devices. |
| Installing-and-Configuring/Flashing-Guides/nitropad-ns50-maximized.md | Updates EC-related module link for Dasharo-based devices. |
| Installing-and-Configuring/Flashing-Guides/index.md | Updates the Purism internal flashing documentation link. |
| Development/make-details.md | Updates the example board configuration link. |
| About/Keys.md | Updates Purism Librem Key documentation link. |
| About/Heads-threat-model.md | Updates references for KGPE-D16 and Binarly LogoFAIL. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 7 out of 7 changed files in this pull request and generated no new comments.
Suppressed comments (2)
Previously missed (1) — in code that hasn't changed since the last review.
Development/make-details.md:55
- Typo: this refers to the initrd as "inird", which makes the sentence harder to read/search for.
are installed in the inird, the Linux kernel configuration and the
coreboot or edk2 configuration.
An example configuration is [`boards/EOL_x230-maximized/EOL_x230-maximized.config`](https://github.com/linuxboot/heads/blob/master/boards/EOL_x230-maximized/EOL_x230-maximized.config)
Development/make-details.md:57
- The doc still states configs live at
board/$BOARD.config, but the example link (and the upstream Heads repo) use theboards/<board>/<board>.configlayout. This is confusing for readers trying to locate the right config file.
coreboot or edk2 configuration.
An example configuration is [`boards/EOL_x230-maximized/EOL_x230-maximized.config`](https://github.com/linuxboot/heads/blob/master/boards/EOL_x230-maximized/EOL_x230-maximized.config)
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 7 out of 7 changed files in this pull request and generated no new comments.
Suppressed comments (1)
Previously missed (1) — in code that hasn't changed since the last review.
Development/make-details.md:55
- Typo: "inird" should be "initrd" (matches earlier references to initrd in this file and in the Heads build terminology).
are installed in the inird, the Linux kernel configuration and the
6b0d129 to
00eded7
Compare
85a46d8 to
7899366
Compare
…s referral (#239) These Dasharo boards ship pre-flashed with Dasharo/Heads from NovaCustom/Nitrokey; external flashing is not required for them. Remove unverifiable home-made claims (external flash requirement, WSON probe, EC flashing, SMBIOS extraction).
…ximized suffix (#239) These boards only set the HAP bit in the IFD and do not neuter the Intel ME, so they are not 'maximized' boards.
Talos is POWER9 with no Intel ME and no blobs.
'maximized' is reserved for boards with the Intel ME neutered/cleaned (at least some ME modules removed). These boards only set the HAP bit in the IFD and do not neuter the ME: NovaCustom v540tu/v560tu/nv4x, NitroPad ns50, MSI Z790-P/Z690-A, and Talos (POWER9, no ME, no blobs).
1e85af9 to
345a160
Compare
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 12 out of 12 changed files in this pull request and generated no new comments.
Suppressed comments (8)
Installing-and-Configuring/Flashing-Guides/novacustom-v540tu.md:4
- Front matter title/permalink drop the “Maximized” naming, but the page H1 still reads “NovaCustom V540TU (Maximized)”. This creates inconsistent naming and undermines the “drop -maximized” rename intent; update the H1 to match the new title.
Installing-and-Configuring/Flashing-Guides/novacustom-v560tu.md:4 - Front matter title/permalink drop the “Maximized” naming, but the page H1 still reads “NovaCustom V560TU (Maximized)”. This creates inconsistent naming; update the H1 to match the new title.
Installing-and-Configuring/Flashing-Guides/novacustom-nv4x_adl.md:4 - Front matter title/permalink drop the “Maximized” naming, but the page H1 still reads “NovaCustom NV4x ADL (Maximized)”. This creates inconsistent naming; update the H1 to match the new title.
Installing-and-Configuring/Flashing-Guides/nitropad-ns50.md:4 - Front matter title/permalink drop the “Maximized” naming, but the page H1 still reads “NitroPad NS50 (Maximized)”. This creates inconsistent naming; update the H1 to match the new title.
Installing-and-Configuring/Flashing-Guides/msi_z790p_ddr5.md:4 - Front matter title/permalink drop the “Maximized” naming, but the page H1 still reads “MSI PRO Z790-P (Maximized)”. This creates inconsistent naming; update the H1 to match the new title.
Installing-and-Configuring/Flashing-Guides/msi_z690a_ddr5.md:4 - Front matter title/permalink drop the “Maximized” naming, but the page H1 still reads “MSI PRO Z690-A (Maximized)”. This creates inconsistent naming; update the H1 to match the new title.
Installing-and-Configuring/Flashing-Guides/talos-2.md:4 - Front matter title/permalink drop the “Maximized” naming, but the page H1 still reads “Raptor Talos II (Maximized)”. This creates inconsistent naming; update the H1 to match the new title.
Installing-and-Configuring/Flashing-Guides/novacustom-v540tu.md:50 - PR description lists a broken-link fix for the Heads “dasharo-ec” module (and renaming the link text from ite_ec → dasharo-ec), but this PR currently contains no references to “dasharo-ec” / “modules/dasharo-ec” anywhere in the docs (and the previous ite_ec link appears to have been removed instead). Please update the PR description’s broken-link checklist to match what changed, or add the intended dasharo-ec link if it was meant to remain in the docs.
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 12 out of 12 changed files in this pull request and generated no new comments.
Suppressed comments (7)
Installing-and-Configuring/Flashing-Guides/talos-2.md:4
- This page’s permalink was changed, which will break existing inbound links/bookmarks to the previous "-maximized" URL. Consider adding a redirect from the old permalink so old links keep working (GitHub Pages supports
redirect_fromviajekyll-redirect-from).
Installing-and-Configuring/Flashing-Guides/novacustom-v540tu.md:4 - This page’s permalink was changed, which will break existing inbound links/bookmarks to the previous "-maximized" URL. Consider adding a redirect from the old permalink so old links keep working (GitHub Pages supports
redirect_fromviajekyll-redirect-from).
Installing-and-Configuring/Flashing-Guides/novacustom-v560tu.md:4 - This page’s permalink was changed, which will break existing inbound links/bookmarks to the previous "-maximized" URL. Consider adding a redirect from the old permalink so old links keep working (GitHub Pages supports
redirect_fromviajekyll-redirect-from).
Installing-and-Configuring/Flashing-Guides/novacustom-nv4x_adl.md:4 - This page’s permalink was changed, which will break existing inbound links/bookmarks to the previous "-maximized" URL. Consider adding a redirect from the old permalink so old links keep working (GitHub Pages supports
redirect_fromviajekyll-redirect-from).
Installing-and-Configuring/Flashing-Guides/nitropad-ns50.md:4 - This page’s permalink was changed, which will break existing inbound links/bookmarks to the previous "-maximized" URL. Consider adding a redirect from the old permalink so old links keep working (GitHub Pages supports
redirect_fromviajekyll-redirect-from).
Installing-and-Configuring/Flashing-Guides/msi_z790p_ddr5.md:4 - This page’s permalink was changed, which will break existing inbound links/bookmarks to the previous "-maximized" URL. Consider adding a redirect from the old permalink so old links keep working (GitHub Pages supports
redirect_fromviajekyll-redirect-from).
Installing-and-Configuring/Flashing-Guides/msi_z690a_ddr5.md:4 - This page’s permalink was changed, which will break existing inbound links/bookmarks to the previous "-maximized" URL. Consider adding a redirect from the old permalink so old links keep working (GitHub Pages supports
redirect_fromviajekyll-redirect-from).
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 12 out of 12 changed files in this pull request and generated no new comments.
Suppressed comments (7)
Installing-and-Configuring/Flashing-Guides/novacustom-v560tu.md:4
- Changing the permalink will break any existing inbound links/bookmarks to the previous “-maximized” URL. Consider adding a
redirect_fromentry so the old URL continues to resolve.
Installing-and-Configuring/Flashing-Guides/novacustom-v540tu.md:4 - Changing the permalink will break any existing inbound links/bookmarks to the previous “-maximized” URL. Consider adding a
redirect_fromentry so the old URL continues to resolve.
Installing-and-Configuring/Flashing-Guides/novacustom-nv4x_adl.md:4 - Changing the permalink will break any existing inbound links/bookmarks to the previous “-maximized” URL. Consider adding a
redirect_fromentry so the old URL continues to resolve.
Installing-and-Configuring/Flashing-Guides/nitropad-ns50.md:4 - Changing the permalink will break any existing inbound links/bookmarks to the previous “-maximized” URL. Consider adding a
redirect_fromentry so the old URL continues to resolve.
Installing-and-Configuring/Flashing-Guides/msi_z790p_ddr5.md:4 - Changing the permalink will break any existing inbound links/bookmarks to the previous “-maximized” URL. Consider adding a
redirect_fromentry so the old URL continues to resolve.
Installing-and-Configuring/Flashing-Guides/msi_z690a_ddr5.md:4 - Changing the permalink will break any existing inbound links/bookmarks to the previous “-maximized” URL. Consider adding a
redirect_fromentry so the old URL continues to resolve.
Installing-and-Configuring/Flashing-Guides/talos-2.md:4 - Changing the permalink will break any existing inbound links/bookmarks to the previous “-maximized” URL. Consider adding a
redirect_fromentry so the old URL continues to resolve.
Fixes #232 Repair 7 verified-broken external links: - Binarly LogoFAIL article (About/Heads-threat-model.md) - coreboot KGPE-D16 (About/Heads-threat-model.md) - coreboot Intel FSP (T440p-maximized.md) - Purism Librem Key LUKS decryption (About/Keys.md) - Purism internal flashing commands (Flashing-Guides/index.md) - heads x230 example config (Development/make-details.md) Also fix the 'inird' -> 'initrd' typo and a board-page broken link.
…#239) NovaCustom (v540tu, v560tu, nv4x) and NitroPad (ns50) boards ship pre-flashed from NovaCustom/Nitrokey; external flashing is not required outside of unbricking. Remove unverifiable home-made claims (chip extraction, socket-mounted, two-step flash, EC external flash, WSON-8 probe) and defer to Dasharo's initial-deployment and recovery docs. The MSI Z790-P/Z690-A pages defer to Dasharo's MSI initial-deployment and recovery (CH341A) docs.
'-maximized' is reserved for boards with the Intel ME neutered/cleaned (at least some ME modules removed). These boards only set the HAP bit in the IFD - or have no Intel ME at all (Talos, POWER9) - so the suffix was dropped. Rename the board files, front-matter title+permalink, and H1: - novacustom-v540tu, novacustom-v560tu, novacustom-nv4x_adl - nitropad-ns50 - msi_z790p_ddr5, msi_z690a_ddr5 - talos-2
57930e3 to
59d304c
Compare
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 12 out of 12 changed files in this pull request and generated 1 comment.
Suppressed comments (7)
Installing-and-Configuring/Flashing-Guides/talos-2.md:4
- Changing the permalink will break existing inbound links/bookmarks to the previous “-maximized” URL. If you want to preserve old URLs, add a redirect strategy (e.g.,
redirect_fromwith the jekyll-redirect-from plugin, or a stub page at the old permalink).
Installing-and-Configuring/Flashing-Guides/novacustom-v560tu.md:4 - Changing the permalink will break existing inbound links/bookmarks to the previous “-maximized” URL. If you want to preserve old URLs, add a redirect strategy (e.g.,
redirect_fromwith the jekyll-redirect-from plugin, or a stub page at the old permalink).
Installing-and-Configuring/Flashing-Guides/novacustom-v540tu.md:4 - Changing the permalink will break existing inbound links/bookmarks to the previous “-maximized” URL. If you want to preserve old URLs, add a redirect strategy (e.g.,
redirect_fromwith the jekyll-redirect-from plugin, or a stub page at the old permalink).
Installing-and-Configuring/Flashing-Guides/novacustom-nv4x_adl.md:4 - Changing the permalink will break existing inbound links/bookmarks to the previous “-maximized” URL. If you want to preserve old URLs, add a redirect strategy (e.g.,
redirect_fromwith the jekyll-redirect-from plugin, or a stub page at the old permalink).
Installing-and-Configuring/Flashing-Guides/nitropad-ns50.md:4 - Changing the permalink will break existing inbound links/bookmarks to the previous “-maximized” URL. If you want to preserve old URLs, add a redirect strategy (e.g.,
redirect_fromwith the jekyll-redirect-from plugin, or a stub page at the old permalink).
Installing-and-Configuring/Flashing-Guides/msi_z790p_ddr5.md:4 - Changing the permalink will break existing inbound links/bookmarks to the previous “-maximized” URL. If you want to preserve old URLs, add a redirect strategy (e.g.,
redirect_fromwith the jekyll-redirect-from plugin, or a stub page at the old permalink).
Installing-and-Configuring/Flashing-Guides/msi_z690a_ddr5.md:4 - Changing the permalink will break existing inbound links/bookmarks to the previous “-maximized” URL. If you want to preserve old URLs, add a redirect strategy (e.g.,
redirect_fromwith the jekyll-redirect-from plugin, or a stub page at the old permalink).
| Platform configurations are stored in `boards/$BOARD/$BOARD.config` | ||
| ([list of boards can be found here]({{ site.baseurl }}/Prerequisites#supported-devices)) | ||
| as well as the sub-modules necessary for the system. |
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 12 out of 12 changed files in this pull request and generated no new comments.
Suppressed comments (7)
Installing-and-Configuring/Flashing-Guides/novacustom-v540tu.md:5
- Changing the
permalinkwill break any existing inbound links/bookmarks to the previous*-maximized-flashingURL. Consider adding aredirect_fromentry in the front matter to preserve the old path.
Installing-and-Configuring/Flashing-Guides/novacustom-v560tu.md:5 - Changing the
permalinkwill break any existing inbound links/bookmarks to the previous*-maximized-flashingURL. Consider adding aredirect_fromentry in the front matter to preserve the old path.
Installing-and-Configuring/Flashing-Guides/novacustom-nv4x_adl.md:5 - Changing the
permalinkwill break any existing inbound links/bookmarks to the previous*-maximized-flashingURL. Consider adding aredirect_fromentry in the front matter to preserve the old path.
Installing-and-Configuring/Flashing-Guides/nitropad-ns50.md:5 - Changing the
permalinkwill break any existing inbound links/bookmarks to the previous*-maximized-flashingURL. Consider adding aredirect_fromentry in the front matter to preserve the old path.
Installing-and-Configuring/Flashing-Guides/msi_z790p_ddr5.md:5 - Changing the
permalinkwill break any existing inbound links/bookmarks to the previous*-maximized-flashingURL. Consider adding aredirect_fromentry in the front matter to preserve the old path.
Installing-and-Configuring/Flashing-Guides/msi_z690a_ddr5.md:5 - Changing the
permalinkwill break any existing inbound links/bookmarks to the previous*-maximized-flashingURL. Consider adding aredirect_fromentry in the front matter to preserve the old path.
Installing-and-Configuring/Flashing-Guides/talos-2.md:5 - Changing the
permalinkwill break any existing inbound links/bookmarks to the previous*-maximized-flashingURL. Consider adding aredirect_fromentry in the front matter to preserve the old path.
Address Copilot feedback: reword so the board config is not read as being 'stored in ... as well as the sub-modules'. The config is stored in boards/$BOARD/$BOARD.config and additionally selects the sub-modules required for the system.
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 12 out of 12 changed files in this pull request and generated no new comments.
Suppressed comments (7)
Previously missed (7) — in code that hasn't changed since the last review.
Installing-and-Configuring/Flashing-Guides/talos-2.md:4
- Changing the
permalinkwill break any existing inbound links/bookmarks to the old...-maximized-flashing/URL. This repo’s Jekyll config (just-the-docs remote theme) doesn’t appear to enable a redirect plugin, so the old URL will likely become a hard 404. Consider either keeping the old permalink for stability, or adding explicit redirect stub pages for the previous permalinks.
Installing-and-Configuring/Flashing-Guides/novacustom-v540tu.md:4 - Changing the
permalinkwill break any existing inbound links/bookmarks to the old...-maximized-flashing/URL. This repo’s Jekyll config (just-the-docs remote theme) doesn’t appear to enable a redirect plugin, so the old URL will likely become a hard 404. Consider either keeping the old permalink for stability, or adding explicit redirect stub pages for the previous permalinks.
Installing-and-Configuring/Flashing-Guides/novacustom-v560tu.md:4 - Changing the
permalinkwill break any existing inbound links/bookmarks to the old...-maximized-flashing/URL. This repo’s Jekyll config (just-the-docs remote theme) doesn’t appear to enable a redirect plugin, so the old URL will likely become a hard 404. Consider either keeping the old permalink for stability, or adding explicit redirect stub pages for the previous permalinks.
Installing-and-Configuring/Flashing-Guides/nitropad-ns50.md:4 - Changing the
permalinkwill break any existing inbound links/bookmarks to the old...-maximized-flashing/URL. This repo’s Jekyll config (just-the-docs remote theme) doesn’t appear to enable a redirect plugin, so the old URL will likely become a hard 404. Consider either keeping the old permalink for stability, or adding explicit redirect stub pages for the previous permalinks.
Installing-and-Configuring/Flashing-Guides/msi_z690a_ddr5.md:4 - Changing the
permalinkwill break any existing inbound links/bookmarks to the old...-maximized-flashing/URL. This repo’s Jekyll config (just-the-docs remote theme) doesn’t appear to enable a redirect plugin, so the old URL will likely become a hard 404. Consider either keeping the old permalink for stability, or adding explicit redirect stub pages for the previous permalinks.
Installing-and-Configuring/Flashing-Guides/novacustom-nv4x_adl.md:4 - Changing the
permalinkwill break any existing inbound links/bookmarks to the old...-maximized-flashing/URL. This repo’s Jekyll config (just-the-docs remote theme) doesn’t appear to enable a redirect plugin, so the old URL will likely become a hard 404. Consider either keeping the old permalink for stability, or adding explicit redirect stub pages for the previous permalinks.
Installing-and-Configuring/Flashing-Guides/msi_z790p_ddr5.md:4 - Changing the
permalinkwill break any existing inbound links/bookmarks to the old...-maximized-flashing/URL. This repo’s Jekyll config (just-the-docs remote theme) doesn’t appear to enable a redirect plugin, so the old URL will likely become a hard 404. Consider either keeping the old permalink for stability, or adding explicit redirect stub pages for the previous permalinks.
…rd config example (#239) Renames non-ME-neutered board flashing guides to drop the '-maximized' suffix (and updates permalinks/H1s/titles accordingly). Also clarifies the board config example in make-details so the relation between a board config and its selected sub-modules is explicit.
06bcc2d to
f38a490
Compare
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 12 out of 12 changed files in this pull request and generated no new comments.
Suppressed comments (7)
Installing-and-Configuring/Flashing-Guides/talos-2.md:5
- Changing the permalink will break any existing inbound links/bookmarks to the prior "-maximized" URL. Consider adding a redirect to preserve backward compatibility.
Installing-and-Configuring/Flashing-Guides/novacustom-v560tu.md:5 - Changing the permalink will break any existing inbound links/bookmarks to the prior "-maximized" URL. Consider adding a redirect to preserve backward compatibility.
Installing-and-Configuring/Flashing-Guides/novacustom-v540tu.md:5 - Changing the permalink will break any existing inbound links/bookmarks to the prior "-maximized" URL. Consider adding a redirect to preserve backward compatibility.
Installing-and-Configuring/Flashing-Guides/novacustom-nv4x_adl.md:5 - Changing the permalink will break any existing inbound links/bookmarks to the prior "-maximized" URL. Consider adding a redirect to preserve backward compatibility.
Installing-and-Configuring/Flashing-Guides/nitropad-ns50.md:5 - Changing the permalink will break any existing inbound links/bookmarks to the prior "-maximized" URL. Consider adding a redirect to preserve backward compatibility.
Installing-and-Configuring/Flashing-Guides/msi_z790p_ddr5.md:5 - Changing the permalink will break any existing inbound links/bookmarks to the prior "-maximized" URL. Consider adding a redirect to preserve backward compatibility.
Installing-and-Configuring/Flashing-Guides/msi_z690a_ddr5.md:5 - Changing the permalink will break any existing inbound links/bookmarks to the prior "-maximized" URL. Consider adding a redirect to preserve backward compatibility.
Fixes #232
Fixes #241
This PR (a) repairs 7 verified-broken external links, (b) corrects the flashing guidance on the NovaCustom/NitroPad/MSI board pages, and (c) renames the 7 boards that are not actually ME-neutered so they no longer carry the misleading "-maximized" suffix.
Broken links (#232)
https://www.binarly.io/reports/logofailhttps://15h.org/index.php/ASUS_KGPE-D16https://doc.coreboot.org/soc/intel/fsp/index.htmlhttps://docs.puri.sm/Hardware/acc/lk/luks.htmlhttps://docs.puri.sm/Software/PureBoot/Maintenance/Upgrade.htmlboards/EOL_x230-maximized/EOL_x230-maximized.configDasharo-board flashing guidance
NovaCustom (v540tu, v560tu, nv4x) and NitroPad (ns50) boards ship pre-flashed from NovaCustom/Nitrokey. External flashing is not required outside of unbricking. The board pages now defer to Dasharo's initial-deployment and recovery docs (external flashing = initial deployment = unbricking), removing unverified home-made claims (chip extraction, EC external flash, WSON-8 probe). The MSI Z790-P/Z690-A pages defer to Dasharo's MSI initial-deployment and recovery (CH341A) docs.
Board renames (drop "-maximized")
"-maximized" is reserved for boards with the Intel ME neutered/cleaned (at least some ME modules removed). These boards only set the HAP bit in the IFD — or have no Intel ME at all (Talos, POWER9) — so the suffix was dropped: