Skip to content

Restructure the list, annotate every entry, fix dead links - #96

Merged
Wenzel merged 4 commits into
masterfrom
annotate-and-restructure
Nov 13, 2026
Merged

Wenzel merged 4 commits into
masterfrom
annotate-and-restructure

Conversation

@Wenzel

@Wenzel Wenzel commented Nov 13, 2026 •

Copy link
Copy Markdown
Owner

Summary

 README.md
+  scope statement (build, break, introspect hypervisors)
+  Start here            two ordered reading paths
   Chronology            list -> table, extended 2021-2025
-  Documentation, Books, Courses, Papers
+  Foundations           Specifications / Books / Courses / Papers
-  Mainstream Hypervisors Documentation
+  Hypervisor internals  official docs + internals research per hypervisor
-  Hypervisor Development, Research Projects (by year)
+  Building hypervisors  Tutorials / Teaching / Special-purpose / Production and research
-  Virtual Machine Introspection
+  Introspection and debugging   Tools / Papers and talks
-  Attacking Hypervisors, CVEs, Malware analysis
+  Security              Attacking hypervisors (CVE write-ups merged) / Fuzzing / Confidential VMs / VM detection
+  Related lists
+contributing.md         scope, entry format, what is not accepted
+.github/workflows/links.yml   lychee on PRs and weekly; opens an issue on broken links

Every entry now reads [Title](url) - Author, venue, year. Why it matters. ([slides](url)). Unmaintained and archived repos stay, labelled as such.

Removed (out of scope or unrecoverable): TinyVM, ZeldaOS, Zelda.RISCV, gVisor, Container Virtualization course, Windows Sandbox, Tanenbaum textbook link, Hyper-V TechNet 2012 R2 page, KVM wiki documents page, "Hacking the Hypervisor" (video removed), "Hyper-V #0x1 Hypercalls" (blog deleted, no archive). The Hypervisor From Scratch and 5 Days series are one entry each, linking the first part.

Fixed: 17 dead links (DOIs for the classic papers, Wayback snapshots for dead blogs and VMware PDFs, new homes for BitVisor, napoca, Hyperseed, SSD advisory); 5 renamed repos; crosvm now points at google/crosvm; the two Challen lecture links were swapped; two slide links pointed at the wrong talk; Firecracker was dated 2017.

Added: LibVMI, libmicrovmi, KVM-VMI, HVMI, HyperDbg, Garfinkel and Rosenblum 2003; a Fuzzing section (kAFL, Hyper-Cube, Nyx, V-Shuttle, Morphuzz, ViDeZZo, HyperPill, hAFL1); a Confidential VMs section (SEV, TDX, CCA, COCONUT-SVSM, SEVered, CacheWarp, WeSee, Heckler); KVM, Xen, QEMU and Hyper-V TLFS docs; kvm OLS 2007, Turtles, KVM/ARM, Firecracker papers; Hypervisor 101 in Rust, illusion-rs, matrix-rs, OpenVMM, pKVM, Bao; An EPYC escape, VMSA-2025-0004.

Evidence

  • Before: 0 of ~167 entries with a description; 17 dead URLs; awesome-lint 55 errors.
    After: All 184 entries have a description. All 203 URLs checked with curl: about 180 return 200; the rest are bot walls that open in a browser (doi.org to ACM, intel.com, Core Security: 403) or Wayback rate limiting (429, snapshots confirmed through the availability API). All in-page anchors resolve.
  • awesome-lint still reports table pipe alignment, the missing awesome / awesome-list repo topics, and in-page anchors used twice (Contents and Start here). Left as is.
  • The link workflow has not run yet; this PR is its first run.

Merge Danger

Door: two-way

A single commit touching documentation only; revert restores the old README.

Blast Radius: anchors

Section anchors changed, so external deep links such as #research-projects or #attacking-hypervisors-1 now land at the top of the page.

Descriptions were written from knowledge of each resource and spot-checked against page and video titles, not by re-reading every item. Dates added to the Chronology (Milan, CCA, Sapphire Rapids, Linux 6.11 and 6.16) are worth a second look.

Not part of this PR: repo topics, closing issues #41 #63 #64 #83 and PRs #92 #95 as out of scope, a sourcing pass over 2021-2026 conference talks.

- state the scope and regroup entries by purpose
- give every entry an author, venue or year, and a one-line description
- replace dead and moved links with stable or archived URLs
- add VMI tools, fuzzing, confidential VMs and post-2020 material
- add contributing.md and a weekly link check
@Wenzel
Wenzel merged commit b822dde into master Nov 13, 2026
1 check passed
@Wenzel
Wenzel deleted the annotate-and-restructure branch November 13, 2026 01:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant