-
Notifications
You must be signed in to change notification settings - Fork 1.8k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Tidy docs for Device API #4361
Tidy docs for Device API #4361
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,14 +1,17 @@ | ||
# Device | ||
|
||
The Device-API following functionality matrix indicates which devices are | ||
Firecracker provides the _Device_ API to let you manage the virtual hardware | ||
available inside each microVM. | ||
|
||
The Device API following functionality matrix indicates which devices are | ||
required for an API call to be usable. | ||
|
||
**O** - Optional: The device (column) **is not required** for a Firecracker | ||
microVM API call to succeed. If the device (column) is omitted from a uVM | ||
microVM API call to succeed. If the device (column) is omitted from a μVM | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We prefer to use either There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Let's use microVM. The docs don't use “uVM” outside this page. (μ is an abbreviation for micro, which is why I suggested it). |
||
definition, a call to one of the [API Endpoints](#api-endpoints) will succeed. | ||
|
||
**R** - Required: The device (column) **is required** for a Firecracker microVM | ||
API call to succeed. If the device (column) is omitted from a uVM definition, | ||
API call to succeed. If the device (column) is omitted from a μVM definition, | ||
a call to one of the [API Endpoints](#api-endpoints) will fail with a | ||
400 - BadRequest - HTTP response. | ||
|
||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There is no
Device
API. The Device-API means Device <-> API matrix.There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
OK. Good to know. The existing doc is confusing.