Added method signatures for link retrieval

Author: bastianeicher

docs/link-handling/index.md

@@ -13,26 +13,54 @@ All endpoints provide methods for resolving links:
 
 === "C#"
 
-    - `GetLinks(rel)` - Resolves all links with a specific relation type
-    - `Link(rel)` - Resolves a single link with a specific relation type
-    - `LinkTemplate(rel, variables)` - Resolves a link template with variables
+    ```csharp
+    // Resolves all links with a specific relation type.
+    IReadOnlyList<(Uri uri, string? title)> GetLinks(string rel);
+
+    // Resolves a single link with a specific relation type.
+    Uri Link(string rel);
+
+    // Resolves a link template with a specific relation type.
+    Uri LinkTemplate(string rel, IDictionary<string, object> variables);
+    ```
 
 === "Java"
 
-    - `getLinks(rel)` - Resolves all links with a specific relation type
-    - `link(rel)` - Resolves a single link with a specific relation type
-    - `linkTemplate(rel, variables)` - Resolves a link template with variables
+    ```java
+    // Resolves all links with a specific relation type.
+    List<Pair<URI, String>> getLinks(String rel);
+
+    // Resolves a single link with a specific relation type.
+    URI link(String rel);
+
+    // Resolves a link template with a specific relation type.
+    URI linkTemplate(String rel, Map<String, Object> variables);
+    ```
 
 === "Kotlin"
 
-    - `getLinks(rel)` - Resolves all links with a specific relation type
-    - `link(rel)` - Resolves a single link with a specific relation type
-    - `linkTemplate(rel, variables)` - Resolves a link template with variables
+    ```kotlin
+    // Resolves all links with a specific relation type.
+    fun getLinks(rel: String): List<Pair<URI, String?>>
+
+    // Resolves a single link with a specific relation type.
+    fun link(rel: String): URI
+
+    // Resolves a link template with a specific relation type.
+    fun linkTemplate(rel: String, variables: Map<String, Any>): URI
+    ```
 
 === "TypeScript"
 
-    - `getLinks(rel)` - Resolves all links with a specific relation type
-    - `link(rel)` - Resolves a single link with a specific relation type
-    - `linkTemplate(rel, variables)` - Resolves a link template with variables
+    ```typescript
+    // Resolves all links with a specific relation type.
+    getLinks(rel: string): { uri: URL; title?: string; }[];
+
+    // Resolves a single link with a specific relation type.
+    link(rel: string): URL;
+
+    // Resolves a link template with a specific relation type.
+    linkTemplate(rel: string, variables: { [key: string]: any; }): URL;
+    ```
 
 These methods use cached data from the last response. On cache miss, they perform a lazy lookup using HTTP `HEAD`.