Rework some of the Ubuntu docs

[adegeo]

Type of issue

Outdated article

Description

The Ubuntu docs could use some love. The user experience of hitting the overview article is a bit of an overload and doesn't really tell the user where to go or what to do if they're just trying to get .NET installed. Part of this bad experience is generated from the path a user takes from the .NET Downloads page. They're directed to the Linux Overview article which then links them to the Ubuntu Overview article. Instead, it should link directly to the Ubuntu Install article.

Additionally, people may feel the need to hit the overview first when going to install, which may not really help them get going. We've identified a few things we can do to simplify the process and hopefully improve the user experience:

• Overview article should start with a list of supported Ubuntu versions instead of the table of methods of installing.
  • Let's take a look at what the older overview articles for Ubuntu had, before a lot of the troubleshooting problems appeared and we had to patch the docs up over and over.
• Overview should be broken into two articles
  • Decision guide
  • Simple introduction (could we actually just do this on the install page??)
• The install article should be the article that's linked to from the overview page, and it should be listed first in the TOC.
  • Further, the TOC section should be expanded.

Page URL

https://learn.microsoft.com/en-us/dotnet/core/install/linux-ubuntu

Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/install/linux-ubuntu.md

Document Version Independent Id

1d732b15-9e64-633a-000c-ad96d9d3818a

Article author

@adegeo

Metadata

• ID: 80707602-f283-e796-d3b8-3287fbc011dc
• PlatformId: 4edbbf7f-1e61-02f5-393e-a793c035e38f
• Service: dotnet-fundamentals
• Sub-service: install

Related Issues

---

Associated WorkItem - 402703