Skip to content
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

[meta] update docs for API traits #6486

Merged
merged 1 commit into from
Aug 29, 2024

Conversation

sunshowers
Copy link
Contributor

@sunshowers sunshowers commented Aug 29, 2024

All of Omicron's OpenAPI documents have been converted over to API traits. Update documentation to reflect that.

Created using spr 1.3.6-beta.1
Comment on lines -282 to -300
// 2. Add the new kind to <repo root>/clients/src/lib.rs.
// The mapping from `UpdateArtifactKind::*` to `types::UpdateArtifactKind::*`
// must be left as a `todo!()` for now; `types::UpdateArtifactKind` will not
// be updated with the new variant until step 5 below.
//
// 4. Add the new kind and the mapping to its `update_artifact_kind` to
// <repo root>/nexus/db-model/src/update_artifact.rs
//
// 5. Regenerate the OpenAPI specs for nexus and sled-agent:
//
// ```
// EXPECTORATE=overwrite cargo nextest run -p omicron-nexus -p omicron-sled-agent openapi
// ```
//
// 6. Return to <repo root>/{nexus-client,sled-agent-client}/lib.rs from step 2
// and replace the `todo!()`s with the new `types::UpdateArtifactKind::*`
// variant.
//
// See https://github.com/oxidecomputer/omicron/pull/2300 as an example.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

screen-shot-2019-07-24-at-1-29-59-pm-1563989459

@sunshowers sunshowers requested review from smklein and iliana August 29, 2024 22:21
@sunshowers sunshowers enabled auto-merge (squash) August 29, 2024 22:27
@sunshowers sunshowers merged commit 27191f0 into main Aug 29, 2024
22 checks passed
@sunshowers sunshowers deleted the sunshowers/spr/meta-update-docs-for-api-traits branch August 29, 2024 23:38
hawkw pushed a commit that referenced this pull request Aug 31, 2024
All of Omicron's OpenAPI documents have been converted over to API
traits. Update our documentation to reflect that.
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.

2 participants