docs: document the x86-64-v2 CPU requirement - #738
Conversation
Signed-off-by: Amarachi Iheanacho <amarachi.iheanacho@siderolabs.com>
9d817b5 to
faa1bd8
Compare
|
Read this while it's still in draft, so just notes rather than a review. The substance holds up well. The version claim checks out on every page you touched. I verified against upstream rather than the release notes alone: The boot error text is byte-identical to the source, and the v1.7 floor is exactly right. The three strings live in All 28 added links resolve. I checked each one mechanically: target file exists in the same version tree, and for anchored links the heading exists in that file and slugifies to the anchor. Zero failures, no cross-version leakage. The two anchor spellings correctly track the two heading spellings, which is the seven-of-eight bug I was looking for and didn't find. The heading is fine. Two nits for when you mark it ready:
Also worth noting the One thing that is out of scope here, filing separately: |
|
|
||
| For production, it is often more efficient to dedicate a smaller disk for the Talos installation itself, and use additional disks for workload storage. Using a large, single disk for both system and workloads is supported, but may not be optimal depending on your environment. | ||
|
|
||
| ## CPU architecture |
There was a problem hiding this comment.
this applies to amd64 only, arm64 is not covered here
What
Documents Talos's x86-64-v2 CPU microarchitecture requirement across all 8 live versions (v1.7–v1.14): added to System Requirements, restored on the Proxmox
kvm64workaround (v1.11–v1.14, where it had been dropped), and linked from theGOAMD64build option in Building Custom Talos Images.Why
Closes #725. Talos halts at boot below x86-64-v2 with no matching page to land on and no explanation for the existing
kvm64/GOAMD64workarounds — readers hit the wall with no way to search their way out.Change
GOAMD64option.kvm64table row and workaround.GOAMD64=v1now links back to the requirement it works around.Testing
make broken-links,make validate-docs-nav,make style-check-changed STYLE_CHECK_BASE=upstream/main,make docs.json && git diff --exit-code