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

Register Workflows Media Types #71

Open
Tracked by #49
frankkilcommins opened this issue Sep 27, 2023 · 8 comments
Open
Tracked by #49

Register Workflows Media Types #71

frankkilcommins opened this issue Sep 27, 2023 · 8 comments
Assignees
Labels
enhancement New feature or request

Comments

@frankkilcommins
Copy link
Collaborator

frankkilcommins commented Sep 27, 2023

Ideally we should have a media types for workflows so that they can be exposed as proper resources.

Once registered etc., we should add the relevant information to the specification.

@frankkilcommins frankkilcommins added the implementor-draft In scope for first version label Sep 27, 2023
@frankkilcommins frankkilcommins changed the title Register Workflows Media Type Register Workflows Media Types Sep 27, 2023
@frankkilcommins
Copy link
Collaborator Author

Registrations filed:

  • 1287426 application/vnd.oai.workflows registration request
  • 1287428 application/vnd.oai.workflows+json registration request
  • 1287429 application/vnd.oai.workflows+yaml registration request

@handrews
Copy link
Contributor

handrews commented Nov 15, 2023

Shouldn't this be coordinated with the existing draft RFC to register the main OAS media types?

@frankkilcommins
Copy link
Collaborator Author

I don't know if it needs to be coordinated with the existing RFC (which I've only recently found). This has followed the existing IANA registration process.

It would be nice if eventually it ends up in the RFC but I don't see one blocking the other in any way. @darrelmiller is anyway the expert reviewer for the media types registry so he's in the loop and aware of both 😉

@frankkilcommins
Copy link
Collaborator Author

The registration of Media Types for the Workflows Specification with IANA has been completed.

Registrations:

The specification was updated to support the registration process with the addition of:

@frankkilcommins
Copy link
Collaborator Author

ToDo: define fragment identifier considerations and update registrations

@handrews
Copy link
Contributor

@frankkilcommins I recall some conversation (but have forgotten where it was) about not using the vnd. prefix so workflows are aligned with the OAS media type registrations. Was that resolved, and if so is there an rationale I can read somewhere?

@frankkilcommins
Copy link
Collaborator Author

@handrews I had a chat with @darrelmiller on this and the thought process is to wait until there's a clear process in place for supporting "Community Specifications". This process will likely be trashed out as part of the OAS media type registrations. Once done we can then make a request to add a new media type for Workflows and at that point we'll decide if we want to mark the vnd one as deprecated.

@handrews
Copy link
Contributor

@frankkilcommins thanks so much for the explanation! That makes sense to me.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants