Skip to content

Adjust Linux landing and Ubuntu pages #45551

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

Merged
merged 6 commits into from
Mar 28, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 2 additions & 46 deletions .openpublishing.redirection.core.json
Original file line number Diff line number Diff line change
Expand Up @@ -765,57 +765,13 @@
"source_path_from_root": "/docs/core/install/linux-package-manager-sles15.md",
"redirect_url": "/dotnet/core/install/linux-sles"
},
{
"source_path_from_root": "/docs/core/install/linux-package-manager-ubuntu-1604.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu"
},
{
"source_path_from_root": "/docs/core/install/linux-package-manager-ubuntu-1804.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu"
},
{
"source_path_from_root": "/docs/core/install/linux-package-manager-ubuntu-1904.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu"
},
{
"source_path_from_root": "/docs/core/install/linux-package-manager-ubuntu-1910.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu"
},
{
"source_path_from_root": "/docs/core/install/linux-package-manager-ubuntu-2004.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu"
},
{
"source_path_from_root": "/docs/core/install/linux-package-managers.md",
"redirect_url": "/dotnet/core/install/linux"
},
{
"source_path_from_root": "/docs/core/install/linux-ubuntu-1604.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-1604"
},
{
"source_path_from_root": "/docs/core/install/linux-ubuntu-1804.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-1804"
},
{
"source_path_from_root": "/docs/core/install/linux-ubuntu-2004.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2004"
},
{
"source_path_from_root": "/docs/core/install/linux-ubuntu-2204.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2204"
},
{
"source_path_from_root": "/docs/core/install/linux-ubuntu-2210.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-other"
},
{
"source_path_from_root": "/docs/core/install/linux-ubuntu-2304.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2304"
},
{
"source_path_from_root": "/docs/core/install/linux-ubuntu-2310.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2310"
"source_path_from_root": "/docs/core/install/linux-ubuntu.md",
"redirect_url": "/dotnet/core/install/linux-ubuntu-install"
},
{
"source_path_from_root": "/docs/core/install/runtime.md",
Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/includes/linux-ubuntu-80-ms.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,4 @@ ms.topic: include
ms.custom: linux-related-content
---

.NET 8.0 isn't available in the Ubuntu package repository. [Register the Microsoft package repository](../linux-ubuntu.md#register-the-microsoft-package-repository) and use that feed to install .NET through APT. If you use the Microsoft package repository to install .NET, you should deprioritize .NET packages from the Ubuntu repository. For more information, see [I need a version of .NET that isn't provided by my Linux distribution](../linux-package-mixup.md?pivots=os-linux-ubuntu#i-need-a-version-of-net-that-isnt-provided-by-my-linux-distribution).
.NET 8.0 isn't available in the Ubuntu package repository. [Register the Microsoft package repository](../linux-ubuntu-decision.md#register-the-microsoft-package-repository) and use that feed to install .NET through APT. If you use the Microsoft package repository to install .NET, you should deprioritize .NET packages from the Ubuntu repository. For more information, see [I need a version of .NET that isn't provided by my Linux distribution](../linux-package-mixup.md?pivots=os-linux-ubuntu#i-need-a-version-of-net-that-isnt-provided-by-my-linux-distribution).
2 changes: 1 addition & 1 deletion docs/core/install/includes/linux-ubuntu-feed-sdk-note.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ ms.custom: linux-related-content
---

> [!IMPORTANT]
> If you're using .NET 8 SDK and Ubuntu 22.04, understand that SDK versions offered by Canonical are always in the [.1xx feature band](../../versions/index.md#versioning-details). If you want to use a newer feature band release, use the [Microsoft feed to install the SDK](../linux-ubuntu.md#register-the-microsoft-package-repository). Make sure you review the information in the [.NET package mix ups on Linux](../linux-package-mixup.md?pivots=os-linux-ubuntu#whats-going-on) article to understand the implications of switching between repository feeds.
> If you're using .NET 8 SDK and Ubuntu 22.04, understand that SDK versions offered by Canonical are always in the [.1xx feature band](../../versions/index.md#versioning-details). If you want to use a newer feature band release, use the [Microsoft feed to install the SDK](../linux-ubuntu-decision.md#register-the-microsoft-package-repository). Make sure you review the information in the [.NET package mix ups on Linux](../linux-package-mixup.md?pivots=os-linux-ubuntu#whats-going-on) article to understand the implications of switching between repository feeds.
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,4 @@ ms.topic: include
ms.custom: linux-related-content
---

.NET is available in the Ubuntu package manager feeds, as well as the Microsoft package repository. However, you should only use one or the other to install .NET. Microsoft recommends that you use the Ubuntu package manager feeds. If you want to use the Microsoft package repository, see [How to register the Microsoft package repository](../linux-ubuntu.md#register-the-microsoft-package-repository).
.NET is available in the Ubuntu package manager feeds, as well as the Microsoft package repository. However, you should only use one or the other to install .NET. Microsoft recommends that you use the Ubuntu package manager feeds. If you want to use the Microsoft package repository, see [How to register the Microsoft package repository](../linux-ubuntu-decision.md#register-the-microsoft-package-repository).
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,4 @@ ms.topic: include
ms.custom: linux-related-content
---

The default Ubuntu package repository doesn't contain this version of .NET. Use the [Microsoft package repository instead](../linux-ubuntu.md#register-the-microsoft-package-repository).
The default Ubuntu package repository doesn't contain this version of .NET. Use the [Microsoft package repository instead](../linux-ubuntu-decision.md#register-the-microsoft-package-repository).
2 changes: 1 addition & 1 deletion docs/core/install/index.yml
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ landingContent:
- text: SUSE Linux Enterprise Server
url: linux-sles.md
- text: Ubuntu
url: linux-ubuntu.md
url: linux-ubuntu-decision.md

# Card
- title: "Q&A"
Expand Down
4 changes: 2 additions & 2 deletions docs/core/install/linux-package-mixup.md
Original file line number Diff line number Diff line change
Expand Up @@ -224,15 +224,15 @@ Configure your package manager to ignore the .NET packages from the distribution
> ```

> [!TIP]
> If you registered the [Ubuntu .NET backports package repository](linux-ubuntu.md#ubuntu-net-backports-package-repository) you should [unregister the Ubuntu .NET backports package repository](linux-ubuntu.md#unregister-the-ubuntu-net-backports-package-repository) instead of configuring your package manager to ignore the contained .NET packages. Otherwise your package manager pulls the package index from this repository, just to ignore it, because the repository only contains .NET packages. This effectively slows down updating your local package index every time you call `apt update`.
> If you registered the [Ubuntu .NET backports package repository](linux-ubuntu-decision.md#ubuntu-net-backports-package-repository) you should [unregister the Ubuntu .NET backports package repository](linux-ubuntu-decision.md#unregister-the-ubuntu-net-backports-package-repository) instead of configuring your package manager to ignore the contained .NET packages. Otherwise your package manager pulls the package index from this repository, just to ignore it, because the repository only contains .NET packages. This effectively slows down updating your local package index every time you call `apt update`.
>
> Use the `apt-cache policy` command to check if you registered the Ubuntu .NET backports package repository:
>
> ```bash
> apt-cache policy '?name(dotnet.*)' | grep 'ppa.launchpadcontent.net/dotnet/backports' | sort -u
> ```

01. Reinstall .NET from the Microsoft package feed. For more information, see [Install .NET on Linux](linux.md). If using Ubuntu, see [My Ubuntu distribution doesn't include the .NET version I want, or I need an out-of-support .NET version](linux-ubuntu.md#my-ubuntu-distribution-doesnt-include-the-net-version-i-want-or-i-need-an-out-of-support-net-version).
01. Reinstall .NET from the Microsoft package feed. For more information, see [Install .NET on Linux](linux.md). If using Ubuntu, see [My Ubuntu distribution doesn't include the .NET version I want, or I need an out-of-support .NET version](linux-ubuntu-decision.md#my-ubuntu-distribution-doesnt-include-the-net-version-i-want-or-i-need-an-out-of-support-net-version).

::: zone-end

Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/linux-scripted-manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ It's possible that when you install .NET, specific dependencies may not be insta
- [Fedora](linux-fedora.md#dependencies)
- [RHEL and CentOS Stream](linux-rhel.md#dependencies)
- [SLES](linux-sles.md#dependencies)
- [Ubuntu](linux-ubuntu.md#dependencies)
- [Ubuntu](linux-ubuntu-decision.md#dependencies)

For generic information about the dependencies, see [Self-contained Linux apps](https://github.com/dotnet/core/blob/main/Documentation/self-contained-linux-apps.md).

Expand Down
Loading