Ask for API version when user associates pull request

[ladonnaq]

Requirement: SDK stakeholders have asked for the API Spec version data. There is not a way to programmatically determine and validate the API version. Update the API readiness milestone to ask the user to enter the API version and update the API Spec work item field API Spec version with the input by the user.

Proposed UI changes:

Also in the Release Planner app update the UI with:
API details - Add new field named "API version" with the value of the API version as indicated by the user.

[praveenkuttappan]

I have looked at few TypeSpec spec projects and I don't see any easy way to auto detect API version. So for now, I think we can just ask user to provide API-version.

[ladonnaq]

I have looked at few TypeSpec spec projects and I don't see any easy way to auto detect API version. So for now, I think we can just ask user to provide API-version.

Thanks for investigating! For now user input that is self-attested is better than no data.

We should open an issue and put in backlog. Perhaps we raise requirement to TypeSpec. API version is core metadata.

[praveenkuttappan]

We may not need any user input for API version based on the discussion about TypeSpec based codegen. Let's revisit this change request and decide the plan accordingly.

[ladonnaq]

We may not need any user input for API version based on the discussion about TypeSpec based codegen. Let's revisit this change request and decide the plan accordingly.

The requirement to map API version to SDK version is also applicable for SDKs generated using OpenAPI. Should we have 2 issues - one for TypeSpec and one for OpenAPI?