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

Add basic page for troubleshooting app launch failures #28805

Merged
merged 3 commits into from
Mar 31, 2022

Conversation

elinor-fung
Copy link
Member

@elinor-fung elinor-fung commented Mar 25, 2022

Summary

Add basic page for troubleshooting app launch failures.

This is very basic/sparse right now - just trying to get a basic landing page so the end-user-facing framework resolution failure link (https://aka.ms/dotnet/app-launch-failed) we are adding in dotnet/runtime#67022 has something it can redirect to.

cc @richlander @vitek-karas

docs/core/runtime-discovery/troubleshoot-app-launch.md Outdated Show resolved Hide resolved
Different Linux distributions provide .NET through different package managers. See [Install .NET on Linux](../install/linux.md) for details. Note that preview versions of .NET are not available through package managers.
::: zone-end

#### Download binaries
Copy link
Member

Choose a reason for hiding this comment

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

@richlander - not sure if we want to promote extracting zips as an install experience. Maybe this should point to some overall "how to install" page just noting the typical difference between default location (should use installers/packages) and non-default location in which case I would recommend usage of the dotnet-install script.

Copy link
Member Author

Choose a reason for hiding this comment

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

I felt like the dotnet-install scripts would be less end-user-friendly? I knew how to download and extract before doing any software development, but I didn't know how to run anything in PowerShell or bash.

Copy link
Member

Choose a reason for hiding this comment

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

I kind of agree - but to a point. I think the general problem with the current web-site/download/install experience as driven by the host is that we don't point to a specific single download - the user still has to choose (click on the right option on the web-site).

The experience for the installers is reasonable in that the web-site has nice, large pictures and text and so on, and it takes like 1-2 clicks to get the thing (assuming you know what - which is another problem).

Downloading the zips is worse - you have to go through the a "All downloads" page which is overwhelming even for me. In that sense, asking the user to run something like dotnet-install.ps1 --version 1.2.3 --framework ASP.NET --location C:\private feels much simpler and also feels much more in-line with the CLI experience which is probably the preferred way for devs anyway. And it's fully scriptable/repeatable (as in - oh I need new SDK for this thing, OK, now it works locally, but what do I add to my CI to make it work there).

But I agree that this is a much larger discussions and should not block these changes in any way.

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's definitely fair. 'All downloads' does have a lot going on and the user needs to map the information in the error message to multiple separate actions/clicks, while the script can just take all the information in a single command.

I'm going to put this in its current state so that we at least have a page. I'll likely add a section pointing at the script later. (And I'm sure we will need some iteration / improvement after.)

Co-authored-by: Vitek Karas <10670590+vitek-karas@users.noreply.github.com>
docs/core/runtime-discovery/troubleshoot-app-launch.md Outdated Show resolved Hide resolved
docs/core/runtime-discovery/troubleshoot-app-launch.md Outdated Show resolved Hide resolved
docs/core/runtime-discovery/troubleshoot-app-launch.md Outdated Show resolved Hide resolved
docs/core/runtime-discovery/troubleshoot-app-launch.md Outdated Show resolved Hide resolved
docs/core/runtime-discovery/troubleshoot-app-launch.md Outdated Show resolved Hide resolved
docs/core/runtime-discovery/troubleshoot-app-launch.md Outdated Show resolved Hide resolved
docs/core/runtime-discovery/troubleshoot-app-launch.md Outdated Show resolved Hide resolved
docs/core/runtime-discovery/troubleshoot-app-launch.md Outdated Show resolved Hide resolved
docs/core/runtime-discovery/troubleshoot-app-launch.md Outdated Show resolved Hide resolved
docs/core/runtime-discovery/troubleshoot-app-launch.md Outdated Show resolved Hide resolved
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
@elinor-fung elinor-fung merged commit b50ba41 into dotnet:main Mar 31, 2022
@elinor-fung elinor-fung deleted the app-launch-failure branch March 31, 2022 01:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants