guide: add standalone resolver architecture page
Open
@juantian8seattle is already working on this.
Since Mar 20, 2026.
documentation
enhancement
Guide
storage
- Dominant language
- Rust
- Stars
- 1.9k
- Forks
- 238
- Avg merge
- 1d 15h
- Merged PRs (30d)
- 100
Description
The OpenHCL resolver pattern (how device configs from VTL0 settings get mapped to concrete device implementations) is used by multiple subsystems -- NVMe VFIO, StorVSC usermode, and potentially future backends.
Currently the pattern is only documented in context-specific places:
nvme_manager/mod.rsmodule docs (NVMe-specific)- StorVSC design docs (storvsc-specific comparison)
A standalone Guide page covering the resolver architecture generically would be useful:
- What
ResourceResolverdoes and how resolvers register - The config -> resolver -> resolved-device pipeline
- How managers (NvmeManager, StorvscManager) coordinate with resolvers
- Pattern for adding new resolver types
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.