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 docs for community distributions #42849

Open
richlander opened this issue Oct 4, 2024 · 4 comments
Open

Add docs for community distributions #42849

richlander opened this issue Oct 4, 2024 · 4 comments
Assignees
Labels
doc-idea Indicates issues that are suggestions for new topics [org][type][category] fundamentals/subsvc install/subsvc Pri3 📌 seQUESTered Identifies that an issue has been imported into Quest.

Comments

@richlander
Copy link
Member

richlander commented Oct 4, 2024

Describe the issue or suggestion

Arch (and I believe Alpine) don't install ASP.NET Core with the SDK. It would be helpful to cover that.

The AUR is quite awesome. It is one of the only ways to get .NET previews via a package manager. I have relied on that quite a bit for preview testing.


Associated WorkItem - 323540

@dotnetrepoman dotnetrepoman bot added ⌚ Not Triaged Not triaged and removed rerun-action-opened labels Oct 10, 2024
@adegeo adegeo added install/subsvc fundamentals/subsvc doc-idea Indicates issues that are suggestions for new topics [org][type][category] labels Oct 10, 2024
@dotnetrepoman dotnetrepoman bot removed the ⌚ Not Triaged Not triaged label Oct 10, 2024
@adegeo adegeo self-assigned this Oct 10, 2024
@dotnetrepoman dotnetrepoman bot added 🗺️ mapQUEST Only used as a way to mark an issue as updated for quest. RepoMan should instantly remove it. and removed 🗺️ mapQUEST Only used as a way to mark an issue as updated for quest. RepoMan should instantly remove it. labels Oct 10, 2024
@adegeo adegeo added 📌 seQUESTered Identifies that an issue has been imported into Quest. 🗺️ reQUEST Triggers an issue to be imported into Quest. and removed 📌 seQUESTered Identifies that an issue has been imported into Quest. labels Oct 10, 2024
@sequestor sequestor bot added 📌 seQUESTered Identifies that an issue has been imported into Quest. and removed 🗺️ reQUEST Triggers an issue to be imported into Quest. labels Oct 11, 2024
@adegeo
Copy link
Contributor

adegeo commented Oct 28, 2024

@richlander I'm not sure about this. It's not officially supported by the product team, right? Currently we're only including distros in the supported-os github page.

Maybe we could have some sort of "other" distro page that lists ways to install .NET on the non-supported OS, with a disclaimer, and links to their documentation if available? Such as a link to https://wiki.archlinux.org/title/.NET

@richlander
Copy link
Member Author

Arch is supported via "best effort" per https://github.com/dotnet/core/blob/main/linux.md.

The main topic to cover somewhere is that some distros don't include ASP.NET Core in their SDK distribution and that's something to check/be aware of. It doesn't have to be a page on Arch, in particular. Maybe we should have a page that documents our approach for other Linux distributions.

FYI: I just validated that Alpine doesn't have this challenge. Their .NET 8 SDK package includes ASP.NET Core.

@adegeo adegeo moved this from 🔖 Ready to 🏗 In progress in dotnet/docs December 2024 Sprint Dec 6, 2024
@dotnetrepoman dotnetrepoman bot added 🗺️ mapQUEST Only used as a way to mark an issue as updated for quest. RepoMan should instantly remove it. and removed 🗺️ mapQUEST Only used as a way to mark an issue as updated for quest. RepoMan should instantly remove it. labels Dec 6, 2024
@adegeo
Copy link
Contributor

adegeo commented Dec 13, 2024

I still don't like adding the cost of maintaining an official doc on something that's not kept up-to-date and has some issues.

Looking at https://archlinux.org/packages/?sort=&q=dotnet I notice the following things:

  1. .NET 9 is missing.
  2. .NET 8 is flagged as out-of-date for some reason.
  3. ASP.NET runtime is completely missing.
  4. And the issue you said with the SDK missing the ASP.NET Runtime component seems odd too.

I just don't think we should create official documentation to cover the problems created by a community maintainer (as good intentioned as it may be) for a distro we're not really involved in.

Is the following scenario possible? The community maintainer creating the packages injects malware into the packages. The official MS docs tell users to go install these packages. Are we liable somehow?

Perhaps a github discussion with this information is more appropriate?

@richlander richlander changed the title Add docs for Arch Linux Add docs for community distributions Dec 29, 2024
@richlander
Copy link
Member Author

richlander commented Dec 29, 2024

I don't think any of things actually matter. It's a question of whether we describe a distribution as official or not. I don't see it as our role to protect people from using the web.

I think we have a dual role:

  • Document UX that are Microsoft-provided for people that care about that, noting that MS-provided solutions often build on top of third party solutions.
  • Document links to UX provided by others as a means of increasing visibility for users and support the .NET ecosystem beyond what Microsoft does.

I changed the title to capture that.

Here are more to consider:

That's a partial list. Where should we document that these options are available? I don't think a GH issues is a good solution.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
doc-idea Indicates issues that are suggestions for new topics [org][type][category] fundamentals/subsvc install/subsvc Pri3 📌 seQUESTered Identifies that an issue has been imported into Quest.
Projects
Status: 🏗 In progress
Development

No branches or pull requests

2 participants