Soft deprecate Link

CHANGELOG.md

@@ -4,6 +4,16 @@
 
 This version moves all Form helpers to a [separate library](https://github.com/surface-ui/surface_form). Form Helpers are no longer used in new apps from Surface v0.12. Older applications who wish to maintain compatibility, add `{:surface_form, "~> 0.1.0"}` to your `mix.exs`.
 
+## v0.11.3 (yyyy-mm-dd)
+
+* Restrict phoenix_live_view version up to `0.20.9` due to compatibility
+  issues introduced by phoenix_live_view `0.20.10` regarding debug annotations.
+
+### Soft Deprecations
+
+* `Link` has been deprecated in favor of liveview's built-in `<.link>`.
+    See <https://hexdocs.pm/phoenix_live_view/live-navigation.html> for more info.
+
 ## v0.11.2 (2024-02-19)
 
 * Add support for Liveview >= `v0.20` (#714)

lib/surface/components/link.ex

@@ -1,5 +1,11 @@
 defmodule Surface.Components.Link do
   @moduledoc """
+  > #### Soft deprecation warning {: .warning}
+  >
+  > This component has been deprecated in favor of liveview's built-in `<.link>`
+  > and will be removed in `v0.13`. See https://hexdocs.pm/phoenix_live_view/live-navigation.html for
+  > more info usage.
+
   Generates a link to the given URL.
 
   Provides similar capabilities to Phoenix's built-in `link/2` function.
@@ -26,6 +32,8 @@ defmodule Surface.Components.Link do
   ```
   """
 
+  @moduledoc deprecated: "Use liveview's built-in `<.link>` instead"
+
   use Surface.Component
   use Surface.Components.Events