Add version notes and interoperability warnings to documentation

Co-authored-by: bastianeicher <414366+bastianeicher@users.noreply.github.com>

Author: Copilot

docs/link-handling/link-header.md

@@ -93,6 +93,9 @@ Link: </contacts{?name,email}>; rel="search"; templated=true
 
 This combines the Link header mechanism with URI template support. While not part of RFC 8288, this extension provides a convenient way to express templated links without requiring HAL or another hypermedia format.
 
+!!! warning
+    The `templated=true` extension is not standard and may not be recognized by other HTTP clients or generic Link header parsers. If interoperability with non-TypedRest clients is important, consider using HAL for templated links instead.
+
 When `templated=true` is present, use `LinkTemplate()` instead of `Link()`:
 
 === "C#"

docs/link-handling/serializers.md

@@ -43,6 +43,9 @@ To use the newer `System.Text.Json` serializer, install the `TypedRest.SystemTex
 dotnet add package TypedRest.SystemTextJson
 ```
 
+!!! note
+    The `TypedRest.SystemTextJson` package version should match your main `TypedRest` package version. Both packages follow the same versioning scheme.
+
 Then configure your endpoint:
 
 === "C#"