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

EOL warnings for V2/V3 runtimes #3771

Merged
merged 2 commits into from
Aug 2, 2023
Merged

EOL warnings for V2/V3 runtimes #3771

merged 2 commits into from
Aug 2, 2023

Conversation

nturinski
Copy link
Member

Fixes #3676

I was going back and forth on the UI a lot here. Feedback welcomed. @ejizba @MadhuraBharadwaj-MSFT

image

image

@nturinski nturinski requested a review from a team as a code owner July 20, 2023 21:02
const noPicksMessage = context.stackFilter ?
localize('noStacksFoundWithFilter', '$(warning) No stacks found for "{0}" on Azure Functions v{1}', context.stackFilter, majorVersion) :
localize('noStacksFound', '$(warning) No stacks found for Azure Functions v{0}', majorVersion);
const upgradeMessage = localize('eolWarning', '$(warning) No stacks found for Azure Functions v{0} due to being EOL. Upgrade your runtime version to see available stacks.')
Copy link
Member

Choose a reason for hiding this comment

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

Forgot to pass majorVersion into the localize call

ejizba
ejizba previously approved these changes Jul 21, 2023
Copy link
Contributor

@ejizba ejizba left a comment

Choose a reason for hiding this comment

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

Added some suggestions, but nothing blocking. Thanks!

{ label: 'Azure Functions v3', data: FuncVersion.v3, description: '(EOL)' },
{ label: 'Azure Functions v2', data: FuncVersion.v2, description: '(EOL)' },
{ label: 'Azure Functions v1', data: FuncVersion.v1 }, {
label: localize('runtimeWarning', `$(extensions-warning-message) Azure Functions runtime v2.x and v3.x have reached the EOL. Learn more...`),
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
label: localize('runtimeWarning', `$(extensions-warning-message) Azure Functions runtime v2.x and v3.x have reached the EOL. Learn more...`),
label: localize('runtimeWarning', `$(extensions-warning-message) v2 and v3 have reached the end of life. Learn more...`),
  • It bothers me if we are inconsistent with "v2" vs "v2.x"
  • I like spelling out acronyms at least once when possible, and this feel like a good place to do "end of life"

{ label: 'Azure Functions v3', data: FuncVersion.v3, description: '(EOL)' },
{ label: 'Azure Functions v2', data: FuncVersion.v2, description: '(EOL)' },
{ label: 'Azure Functions v1', data: FuncVersion.v1 }, {
label: localize('runtimeWarning', `$(extensions-warning-message) Azure Functions runtime v2.x and v3.x have reached the EOL. Learn more...`),
Copy link
Contributor

Choose a reason for hiding this comment

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

It's a bit weird to have two "learn more"s in a row. Potential solutions:

  1. Get rid of one learn more. I guess I think the version overview page is more generally applicable. After all, this prompt in used in several scenarios, including cases where the user doesn't have an existing app they need to migrate.
  2. Update the learn more text. Maybe "Learn how to upgrade to v4..." and "Learn about Azure Functions versioning..."

const noPicksMessage = context.stackFilter ?
localize('noStacksFoundWithFilter', '$(warning) No stacks found for "{0}" on Azure Functions v{1}', context.stackFilter, majorVersion) :
localize('noStacksFound', '$(warning) No stacks found for Azure Functions v{0}', majorVersion);
const upgradeMessage = localize('eolWarning', '$(warning) No stacks found for Azure Functions v{0} due to being EOL. Upgrade your runtime version to see available stacks.')
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
const upgradeMessage = localize('eolWarning', '$(warning) No stacks found for Azure Functions v{0} due to being EOL. Upgrade your runtime version to see available stacks.')
const upgradeMessage = localize('eolWarning', '$(warning) Azure Functions v{0} has reached end of life. Upgrade your runtime version to see available stacks. Learn more...')

I think this message is the best place to have the migration guide link. In this case, we know they have an existing app locally using v3 (otherwise they wouldn't be seeing v3 stacks), so we know they need to migrate

Copy link
Member Author

Choose a reason for hiding this comment

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

That makes sense. I guess knowing the migration guide isn't that useful when you're selecting a runtime version for the first time.

@MadhuraBharadwaj-MSFT
Copy link

@nturinski it looks like we're using the 'warning symbol' for versions that are soon approaching end of life (Python 3.7 in your screenshot above) and the acronym 'EOL' for versions that have already approached end of life. Is this differentiation intended?
My suggestion is to use the 'warning symbol' across all the end-of-life notices irrespective of language versions/host versions that are already retired/soon approaching retirement state. I think this will help maintain consistency and serve as a visual reminder for users that they're using something that's either unsupported or soon-to-be unsupported.

I agree with other suggestions @ejizba made above.

Thank you for working on this @nturinski !

src/FuncVersion.ts Outdated Show resolved Hide resolved
@nturinski
Copy link
Member Author

New UI changes.

image
image

@nturinski nturinski merged commit cd03f1f into main Aug 2, 2023
@nturinski nturinski deleted the nat/runtimeEOL branch August 2, 2023 16:46
@microsoft microsoft locked and limited conversation to collaborators Sep 17, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Show warning that host v3 is EOL when creating an app
5 participants