Skip to content

Commit

Permalink
Merge pull request #17705 from unoplatform/dev/doti/docs-link-fixes
Browse files Browse the repository at this point in the history
docs: Fix links resulting in 404
  • Loading branch information
agneszitte authored Aug 15, 2024
2 parents f6b1bdc + a963c2c commit 58d4be2
Show file tree
Hide file tree
Showing 31 changed files with 57 additions and 54 deletions.
2 changes: 1 addition & 1 deletion doc/articles/Uno-UI-Performance.md
Original file line number Diff line number Diff line change
Expand Up @@ -152,7 +152,7 @@ Here's what to look for:

### Profiling applications

A profiling guide for Uno Platform apps is [available here](ref:Uno.Tutorials.ProfilingApplications).
A profiling guide for Uno Platform apps is [available here](xref:Uno.Tutorials.ProfilingApplications).

### FrameworkTemplatePool

Expand Down
2 changes: 1 addition & 1 deletion doc/articles/common-issues-all-ides.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Try building your project again.

## Runtime error `No parameterless constructor defined for XXXX`

This error is generally caused by some missing [IL Linker](https://github.com/mono/linker/tree/master/docs) configuration on WebAssembly. You may need to add some of your application assemblies in the LinkerConfig.xml file of your project. You can find [additional information in the documentation](features/using-il-linker-webassembly.md).
This error is generally caused by some missing [IL Linker](https://github.com/dotnet/runtime/tree/main/src/tools/illink) configuration on WebAssembly. You may need to add some of your application assemblies in the LinkerConfig.xml file of your project. You can find [additional information in the documentation](xref:uno.articles.features.illinker).

Similar error messages using various libraries:

Expand Down
2 changes: 1 addition & 1 deletion doc/articles/concepts/overview/why-uno-platform.md
Original file line number Diff line number Diff line change
Expand Up @@ -162,7 +162,7 @@ The Uno Platform provides access to SkiaSharp as a render canvas for your app, e

## Animations: Beyond storyboards, access to Lottie and Rive

Based on SkiaSharp support, Uno Platform provides AnimatedVisualPlayer to give the ability to render rich Lottie files directly in your app, for all target platforms.
Based on SkiaSharp support, Uno Platform provides AnimatedVisualPlayer to give the ability to render rich [Lottie files](https://airbnb.io/lottie/#/) directly in your app, for all target platforms.

## Performance and app size with AOT/Jiterpreter

Expand Down
4 changes: 2 additions & 2 deletions doc/articles/contributing/guidelines/issue-triage.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,10 +35,10 @@ Is something unclear? Do we need to improve our documentation or samples?

Community support requests should be directed to:

* Our [documentation](https://platform.uno/docs/) and [troubleshooting guide](https://platform.uno/docs/troubleshooting-guide).
* Our [documentation](https://platform.uno/docs/) and [troubleshooting guide](xref:Uno.UI.CommonIssues).
* [GitHub Discussions](https://github.com/unoplatform/uno/discussions)
* The [Discord Server](https://platform.uno/discord)
* On [Twitter using the #unoplatform](https://twitter.com/search?q=%23unoplatform) hashtag.
* On [X/Twitter using the #unoplatform](https://x.com/search?q=%23unoplatform) hashtag.

Organizations that want a deeper level of support beyond community support should be directed to [contact Uno Platform](https://platform.uno/contact/) to discuss obtaining professional support.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ We use Dependabot to notify the team of any updates to dependencies. Once a week

## Internal dependencies

The following dependencies don't change the public API surface and are typically safe to merge and we could potentially [configure mergify to automatically merge them if CI passes](https://medium.com/mergify/merging-bots-pull-requests-automatically-548ed0b4a424):
The following dependencies don't change the public API surface and are typically safe to merge and we could potentially [configure mergify to automatically merge them if CI passes](https://docs.mergify.com/workflow/automerge/):

- BenchmarkDotNet
- [FluentAssertions](https://github.com/unoplatform/uno/pull/1196)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ User inputs are usually propagated using `RoutedEvents`. See Uno's [routed event
| **_manipulation events_**
| `ManipulationStarting` | Yes | Yes | Yes | Yes | [Documentation](https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.uielement.manipulationstarting) |
| `ManipulationStarted` | Yes | Yes | Yes | Yes | [Documentation](https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.uielement.manipulationstarted) |
| `ManipulationDelta` | Yes | Yes | Yes | Yes | [Documentation](https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.uielement.manipulationedelta) |
| `ManipulationDelta` | Yes | Yes | Yes | Yes | [Documentation](https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.uielement.manipulationdelta) |
| `ManipulationInertiaStarting` | Yes | Yes | Yes | Yes | [Documentation](https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.uielement.manipulationinertiastarting) |
| `ManipulationCompleted` | Yes | Yes | Yes | Yes | [Documentation](https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.uielement.manipulationcompleted) |
| **_gesture events_**
Expand Down
2 changes: 1 addition & 1 deletion doc/articles/features/using-linux-framebuffer.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ uid: Uno.Skia.Linux.Framebuffer

# Using the Linux FrameBuffer and `libinput`

Uno Platform supports the [Linux FrameBuffer](https://www.kernel.org/doc/html/latest/fb/framebuffer.html) and [libinput](https://github.com/wayland-project/libinput) as a target, in the case where your target device does not provide a Window Manager.
Uno Platform supports the [Linux FrameBuffer](https://www.kernel.org/doc/html/latest/fb/framebuffer.html) and [libinput](https://wayland.freedesktop.org/libinput/doc/latest/what-is-libinput.html) as a target, in the case where your target device does not provide a Window Manager.

There are some restrictions for the support for the FrameBuffer:

Expand Down
2 changes: 1 addition & 1 deletion doc/articles/features/using-the-uno-sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ Here are the supported features:
| `Navigation` | Adds support for [Navigation](xref:Uno.Extensions.Navigation.Overview) using [Uno.Extensions](xref:Uno.Extensions.Overview). |
| `LoggingSerilog` | Adds support for [Serilog](https://github.com/serilog/serilog) using [Uno.Extensions](xref:Uno.Extensions.Overview). |
| `Storage` | Adds support for [Storage](xref:Uno.Extensions.Storage.Overview) using [Uno.Extensions](xref:Uno.Extensions.Overview). |
| `Serialization` | Adds support for [Serialization](Uno.Extensions.Serialization.Overview) using [Uno.Extensions](xref:Uno.Extensions.Overview). |
| `Serialization` | Adds support for [Serialization](xref:Uno.Extensions.Serialization.Overview) using [Uno.Extensions](xref:Uno.Extensions.Overview). |
| `Toolkit` | Adds support for the [Uno.Toolkit](xref:Toolkit.GettingStarted). |
| `Material` | Adds support for the [Material Design Theme](xref:Uno.Themes.Material.GetStarted) library. If the `Toolkit` feature is also used, it will add support for the [Material Design Toolkit](xref:Toolkit.GettingStarted.Material) library. |
| `Cupertino` | Adds support for the [Cupertino Design Theme](xref:Uno.Themes.Cupertino.GetStarted) library. If the `Toolkit` feature is also used, it will add support for the [Cupertino Design Toolkit](xref:Toolkit.GettingStarted.Cupertino) library. |
Expand Down
2 changes: 1 addition & 1 deletion doc/articles/features/working-with-accessibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ Setting this property does the following:
- On **Android**, it sets the [`View.ContentDescription`](https://developer.android.com/reference/android/view/View.html#setContentDescription(java.lang.CharSequence)) property
- On **iOS**, it sets the [`UIView.AccessibilityIdentifier`](https://developer.apple.com/documentation/uikit/uiaccessibilityidentification/1623132-accessibilityidentifier) property
- On **macOS**, it sets the [`NSView.AccessibilityIdentifier`](https://developer.apple.com/documentation/appkit/nsaccessibility/1535023-accessibilityidentifier) property
- On **WebAssembly**, it sets [`aria-label`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute) and the `xamlautomationid` property on the HTML element. The [`role`](https://www.w3.org/WAI/PF/HTML/wiki/RoleAttribute) HTML Attribute is also set based on the XAML view type whose `AutomationProperties.AutomationId` was set.
- On **WebAssembly**, it sets [`aria-label`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-label) and the `xamlautomationid` property on the HTML element. The [`role`](https://www.w3.org/WAI/PF/HTML/wiki/RoleAttribute) HTML Attribute is also set based on the XAML view type whose `AutomationProperties.AutomationId` was set.

This property is generally used alongside [Uno.UITest](https://github.com/unoplatform/Uno.UITest) to create UI Tests, and is particularly useful to select items using data-bound identifiers.

Expand Down
2 changes: 1 addition & 1 deletion doc/articles/get-started-next-steps.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ Microsoft MVP Skye Hoefling put together [Uno Platform: Getting Started Series](

### Raspberry Pi Applications with Uno Platform (Free)

If you are looking to bring your cross-platform apps to Raspberry Pi with Uno Platform, Peter Gallagher wrote an [article to help you get started]( https://www.petecodes.co.uk/developing-uwp-apps-for-the-raspberry-pi-with-uno-platform/) or try our [getting started with Raspberry Pi documentation]( https://platform.uno/docs/articles/guides/raspberry-pi/raspberry-pi-intro.html).
If you are looking to bring your cross-platform apps to Raspberry Pi with Uno Platform, Peter Gallagher wrote an [article to help you get started](https://www.petecodes.co.uk/developing-uwp-apps-for-the-raspberry-pi-with-uno-platform/) or try our [getting started with Raspberry Pi documentation](xref:Uno.RaspberryPi.Intro).

### XAML Fundamentals for Web and Mobile (Free)

Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Adds Uno Platform's [Custom Authentication](xref:Learn.Tutorials.Authentication.HowToAuthentication) support to the generated project.
Adds Uno Platform's [Custom Authentication](xref:Uno.Extensions.Authentication.HowToAuthentication) support to the generated project.

Using Uno's authentication tools you can easily integrate in your app a login screen and authenticate users. It also helps you manage and track the state of the app's authentication, by allowing you to log out or switch users as well as other authentication-related actions.

Expand Down Expand Up @@ -44,7 +44,7 @@ Uno.Extensions.Authentication currently supports these types of authentication:
dotnet new unoapp -auth web
```
Read the [Authentication documentation](xref:Overview.Authentication) to get more knowledge about Uno Platform's authentication support and the tools it provides.
Read the [Authentication documentation](xref:Uno.Extensions.Authentication.Overview) to get more knowledge about Uno Platform's authentication support and the tools it provides.
> [!NOTE]
> The Authentication option is selected by default in the Default template, and not in the Blank one.
Expand Down
12 changes: 6 additions & 6 deletions doc/articles/getting-started/wizard/includes/extensions.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ The available extensions are:

Dependency Injection (DI) is an Inversion of Control (IoC) technique that enables consuming classes not to worry about the management or creation of their dependencies and instead rely on a central service to provide it when needed, based on how the provider was configured.

Uno Platform brings the power of [Microsoft Extensions Dependency Injection](https://learn.microsoft.com/dotnet/core/extensions/dependency-injection) to all OSs Uno Platform targets and adds its additional functionality via its Uno.Extensions.DependencyInjection library, which you can learn more about [here](xref:Overview.DependencyInjection).
Uno Platform brings the power of [Microsoft Extensions Dependency Injection](https://learn.microsoft.com/dotnet/core/extensions/dependency-injection) to all operating systems it targets and enhances it with additional functionality through its Uno.Extensions.DependencyInjection library. You can learn more about it in the [Uno.Extensions.DependencyInjection overview](xref:Uno.Extensions.DependencyInjection.Overview).

This is included by default in the recommended preset, but not in the blank preset.

Expand All @@ -24,7 +24,7 @@ dotnet new unoapp -di

This extension provides a way to load application configuration data from and to various sources using the [Options Pattern](https://learn.microsoft.com/dotnet/core/extensions/options). This is included by default in the recommended preset, but not in the blank preset.

Refer to the [Uno Configuration](xref:Overview.Configuration) documentation for more information.
Refer to the [Uno Configuration](xref:Uno.Extensions.Configuration.Overview) documentation for more information.

```dotnetcli
dotnet new unoapp -config
Expand All @@ -34,9 +34,9 @@ dotnet new unoapp -config

Uno.Extensions.Http allows for the registration of API endpoints as multiple typed HttpClient instances. In this centralized location for accessing web resources, the lifecycle of the corresponding HttpMessageHandler objects is managed. Added clients can optionally be configured to use the platform-native handler. Additional functionality is provided to clear cookies or log diagnostic messages in responses. This library uses Microsoft.Extensions.Http for any HTTP-related work. This is included by default in the recommended preset, but not in the blank preset.

For more documentation on HTTP requests, [read the documentation](xref:Overview.Http).
For more documentation on HTTP requests, [read the documentation](xref:Uno.Extensions.Http.Overview).

Refer to the [documentation](xref:Overview.Http#refit) to learn how to use it in an Uno Platform app.
Refer to the [documentation](xref:Uno.Extensions.Http.Overview#Refit) to learn how to use it in an Uno Platform app.

```dotnetcli
dotnet new unoapp -http
Expand All @@ -47,9 +47,9 @@ dotnet new unoapp -http
The Localization extension is responsible for managing globalization in your app.
This enables keeping all translations of your app in a single place and enables the user to easily switch the UI language.

The generated app contains *resw* files which can be used to define the application strings. The defined languages are configured in *appsettings.json*. Follow [this link](Learn.Tutorials.Localization.HowToUseLocalization#3-update-the-ui-culture-with-localizationsettings) to learn how to switch the UI culture.
The generated app contains *resw* files, which are used to define the application strings. The supported languages are configured in *appsettings.json*. To learn how to switch the UI culture, refer to the [localization tutorial](xref:Uno.Extensions.Localization.HowToUseLocalization#4-update-the-ui-culture-with-localizationsettings).

![Visual Studio Solution Explorer showing localization files](assets/localization.jpg)
![Visual Studio Solution Explorer showing localization files](../assets/localization.jpg)

The default settings come with the following pre-set languages: English (*en*), Spanish (*es*), French (*fr*), and Portuguese - Brazil (*pt-BR*).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ As part of the continuing evolution of desktop development on Windows, Microsoft
> [!NOTE]
> The Uno Platform has great support for WinUI 2.x and preview support for WinUI 3:
>
> * For WinUI 2.5, see [Fluent-styled controls](https://platform.uno/docs/articles/features/fluent-styles.html)
> * For WinUI 2.5, see [Fluent-styled controls](xref:Uno.Features.FluentStyles)
> * For WinUI 3, see [Uno Platform 3.3 – Day 0 support for WinUI 3 Preview 3, Android 11](https://platform.uno/blog/uno-platform-3-3-day-0-support-for-winui-3-preview-3-android-11/).
>
> [!TIP]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ Unfortunately, WCF itself has been discontinued, although there are, of course,
> [!TIP]
> In the sample migration of TimeEntryRIA to Uno, ASP.NET Core Web APIs were used. You can find a full article discussing how to consume a web service with Uno below:
>
> * [How to consume a web service](https://platform.uno/docs/articles/howto-consume-webservices.html)
> * [How to consume a web service](xref:Uno.Development.ConsumeWebApi)
>
> [!NOTE]
> You can learn more about alternate service technologies here:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ As discussed earlier, the UWP implementation of the **TimeEntryUno** application
> [!TIP]
> The IdentityServer4 server-side implementation used in the sample mirrors the QuickStart tutorial shown below. :
>
> * [Protecting an API using Client Credentials](http://docs.identityserver.io/en/latest/quickstarts/1_client_credentials.html)
> * [Protecting an API using Client Credentials](https://docs.duendesoftware.com/identityserver/v7/quickstarts/1_client_credentials/)
The code to retrieve the access token is encapsulated within the a class **IdentityServerClient** and uses the **HttpClient** class as well as the **IdentityModel** NuGet package.

Expand Down Expand Up @@ -80,8 +80,8 @@ The code to retrieve the access token is encapsulated within the a class **Ident
> [!TIP]
> You can learn more about platform-specific C# and XAML here:
>
> * [Platform-specific C# code in Uno](https://platform.uno/docs/articles/platform-specific-csharp.html)
> * [Platform-specific XAML markup in Uno](https://platform.uno/docs/articles/platform-specific-xaml.html)
> * [Platform-specific C# code in Uno](xref:Uno.Development.PlatformSpecificCSharp)
> * [Platform-specific XAML markup in Uno](xref:Uno.Development.PlatformSpecificXaml)

1. To supply the required parameters to the **IdentityServerClient** class, add the following constructor:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ As mentioned earlier, the server-side of this service is out-of-scope for the ar
> [!NOTE]
> The implementation of the identity client API will be based heavily on the code discussed in the article below:
>
> * [How to consume a web service](https://platform.uno/docs/articles/howto-consume-webservices.html)
> * [How to consume a web service](xref:Uno.Development.ConsumeWebApi)

## Adding a WebApiBase class

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ The sample application is made up of 3 solutions containing multiple projects an

* Uno.Samples
* reference
* [TimeEntryRia](https://github.com/unoplatform/Uno.Samples/tree/master/reference/TimeEntryRia)
* [TimeEntryRia](https://github.com/unoplatform/Uno.Samples/tree/master/ArchivedProjects/UI/TimeEntryRia/TimeEntryRia)
* UI
* TimeEntry
* [TimeEntryServices](https://github.com/unoplatform/Uno.Samples/tree/master/UI/TimeEntry/TimeEntryServices)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ uid: Uno.SilverlightMigration.UsefulResources
# Useful resources

* Uno Platform:
* [Using Uno - getting started on Visual Studio](https://platform.uno/docs/articles/get-started-vs.html)
* [Using Uno - getting started on Visual Studio](xref:Uno.GetStarted.vs2022)
* Uno Platform Samples:
* [unoplatform/Uno.Samples GitHub Repo](https://github.com/unoplatform/Uno.Samples)
* [Uno.UI.Toolkit.SL GitHub Repo](https://github.com/unoplatform/Uno.UI.Toolkit.SL)
Expand Down
2 changes: 1 addition & 1 deletion doc/articles/howto-consume-webservices.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Throughout the how-to, there will be notes on recommended practices and tips tha
> The complete source code that goes along with this tutorial is available in the [unoplatform/Uno.Samples](https://github.com/unoplatform/Uno.Samples) GitHub repository - [TheCatApiClient](https://github.com/unoplatform/Uno.Samples/tree/master/UI/TheCatApiClient)
>
> [!TIP]
> For a step-by-step guide to installing the prerequisites, see [Getting started on Visual Studio](https://platform.uno/docs/articles/get-started-vs-2022.html)
> For a step-by-step guide to installing the prerequisites, see [Getting started on Visual Studio](xref:Uno.GetStarted.vs2022)
## Task 1 - Create a simple Uno application

Expand Down
2 changes: 1 addition & 1 deletion doc/articles/interop/wasm-javascript-2.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Let's create an app to integrate a Syntax Highlighter named [`PrismJS`](https://

### 0. Before starting

📝 To reproduce the code in this article, you must [prepare development environment using Uno's _Getting Started_ article](../get-started.md).
📝 To reproduce the code in this article, you must [prepare a development environment using Uno's _Getting Started_ article](xref:Uno.GetStarted).

### 1. Create the projects

Expand Down
Loading

0 comments on commit 58d4be2

Please sign in to comment.