Skip to content

Commit 5841303

Browse files
authored
Adjust Linux landing and Ubuntu pages (#45551)
* Tweaks to Ubuntu docs * Experiment with a new tile landing page for linux * Adjust TOC * Index.yml * Rename the root ubuntu page as the decision guide
1 parent 26af726 commit 5841303

12 files changed

+70
-95
lines changed

.openpublishing.redirection.core.json

Lines changed: 2 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -765,57 +765,13 @@
765765
"source_path_from_root": "/docs/core/install/linux-package-manager-sles15.md",
766766
"redirect_url": "/dotnet/core/install/linux-sles"
767767
},
768-
{
769-
"source_path_from_root": "/docs/core/install/linux-package-manager-ubuntu-1604.md",
770-
"redirect_url": "/dotnet/core/install/linux-ubuntu"
771-
},
772-
{
773-
"source_path_from_root": "/docs/core/install/linux-package-manager-ubuntu-1804.md",
774-
"redirect_url": "/dotnet/core/install/linux-ubuntu"
775-
},
776-
{
777-
"source_path_from_root": "/docs/core/install/linux-package-manager-ubuntu-1904.md",
778-
"redirect_url": "/dotnet/core/install/linux-ubuntu"
779-
},
780-
{
781-
"source_path_from_root": "/docs/core/install/linux-package-manager-ubuntu-1910.md",
782-
"redirect_url": "/dotnet/core/install/linux-ubuntu"
783-
},
784-
{
785-
"source_path_from_root": "/docs/core/install/linux-package-manager-ubuntu-2004.md",
786-
"redirect_url": "/dotnet/core/install/linux-ubuntu"
787-
},
788768
{
789769
"source_path_from_root": "/docs/core/install/linux-package-managers.md",
790770
"redirect_url": "/dotnet/core/install/linux"
791771
},
792772
{
793-
"source_path_from_root": "/docs/core/install/linux-ubuntu-1604.md",
794-
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-1604"
795-
},
796-
{
797-
"source_path_from_root": "/docs/core/install/linux-ubuntu-1804.md",
798-
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-1804"
799-
},
800-
{
801-
"source_path_from_root": "/docs/core/install/linux-ubuntu-2004.md",
802-
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2004"
803-
},
804-
{
805-
"source_path_from_root": "/docs/core/install/linux-ubuntu-2204.md",
806-
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2204"
807-
},
808-
{
809-
"source_path_from_root": "/docs/core/install/linux-ubuntu-2210.md",
810-
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-other"
811-
},
812-
{
813-
"source_path_from_root": "/docs/core/install/linux-ubuntu-2304.md",
814-
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2304"
815-
},
816-
{
817-
"source_path_from_root": "/docs/core/install/linux-ubuntu-2310.md",
818-
"redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2310"
773+
"source_path_from_root": "/docs/core/install/linux-ubuntu.md",
774+
"redirect_url": "/dotnet/core/install/linux-ubuntu-install"
819775
},
820776
{
821777
"source_path_from_root": "/docs/core/install/runtime.md",

docs/core/install/includes/linux-ubuntu-80-ms.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,4 +6,4 @@ ms.topic: include
66
ms.custom: linux-related-content
77
---
88

9-
.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).
9+
.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).

docs/core/install/includes/linux-ubuntu-feed-sdk-note.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,4 @@ ms.custom: linux-related-content
77
---
88

99
> [!IMPORTANT]
10-
> 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.
10+
> 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.

docs/core/install/includes/linux-ubuntu-package-feed-both.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,4 +6,4 @@ ms.topic: include
66
ms.custom: linux-related-content
77
---
88

9-
.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).
9+
.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).

docs/core/install/includes/linux-ubuntu-package-feed-ms.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,4 +6,4 @@ ms.topic: include
66
ms.custom: linux-related-content
77
---
88

9-
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).
9+
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).

docs/core/install/index.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ landingContent:
6060
- text: SUSE Linux Enterprise Server
6161
url: linux-sles.md
6262
- text: Ubuntu
63-
url: linux-ubuntu.md
63+
url: linux-ubuntu-decision.md
6464

6565
# Card
6666
- title: "Q&A"

docs/core/install/linux-package-mixup.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -224,15 +224,15 @@ Configure your package manager to ignore the .NET packages from the distribution
224224
> ```
225225
226226
> [!TIP]
227-
> 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`.
227+
> 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`.
228228
>
229229
> Use the `apt-cache policy` command to check if you registered the Ubuntu .NET backports package repository:
230230
>
231231
> ```bash
232232
> apt-cache policy '?name(dotnet.*)' | grep 'ppa.launchpadcontent.net/dotnet/backports' | sort -u
233233
> ```
234234
235-
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).
235+
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).
236236

237237
::: zone-end
238238

docs/core/install/linux-scripted-manual.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ It's possible that when you install .NET, specific dependencies may not be insta
4141
- [Fedora](linux-fedora.md#dependencies)
4242
- [RHEL and CentOS Stream](linux-rhel.md#dependencies)
4343
- [SLES](linux-sles.md#dependencies)
44-
- [Ubuntu](linux-ubuntu.md#dependencies)
44+
- [Ubuntu](linux-ubuntu-decision.md#dependencies)
4545

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

0 commit comments

Comments
 (0)