Add code examples (C#, Java, Kotlin, TypeScript) to all endpoint documentation

Author: Copilot

docs/endpoints/entry.md

@@ -3,3 +3,61 @@
 Represent the top-level URI of an API. Used to address the various resources of the API.
 
 The constructor of the entry endpoint requires you to specify the APIs root URL. It also provides optional parameters to override the default HTTP client, JSON serializer, [error handler](../error-handling/index.md) and [link handler](../link-handling/index.md).
+
+## Usage
+
+=== "C#"
+
+    ```csharp
+    // Create an entry endpoint
+    var client = new EntryEndpoint(new Uri("http://example.com/api/"));
+
+    // With custom HTTP client
+    var httpClient = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
+    var client = new EntryEndpoint(httpClient);
+
+    // Access child endpoints
+    var contacts = new CollectionEndpoint<Contact>(client, "contacts");
+    ```
+
+=== "Java"
+
+    ```java
+    // Create an entry endpoint
+    EntryEndpoint client = new EntryEndpoint(URI.create("http://example.com/api/"));
+
+    // With custom HTTP client
+    HttpClient httpClient = HttpClient.newBuilder()
+        .connectTimeout(Duration.ofSeconds(30))
+        .build();
+    EntryEndpoint client = new EntryEndpoint(httpClient);
+
+    // Access child endpoints
+    CollectionEndpoint<Contact> contacts = new CollectionEndpoint<>(client, "contacts", Contact.class);
+    ```
+
+=== "Kotlin"
+
+    ```kotlin
+    // Create an entry endpoint
+    val client = EntryEndpoint(URI.create("http://example.com/api/"))
+
+    // With custom HTTP client
+    val httpClient = HttpClient.newBuilder()
+        .connectTimeout(Duration.ofSeconds(30))
+        .build()
+    val client = EntryEndpoint(httpClient)
+
+    // Access child endpoints
+    val contacts = CollectionEndpoint(client, "contacts", Contact::class.java)
+    ```
+
+=== "TypeScript"
+
+    ```typescript
+    // Create an entry endpoint
+    const client = new EntryEndpoint(new URL("http://example.com/api/"));
+
+    // Access child endpoints
+    const contacts = new CollectionEndpoint<Contact>(client, "contacts");
+    ```

docs/endpoints/generic/collection.md

@@ -12,3 +12,131 @@ Endpoint for a collection of entities addressable as [Element endpoints](element
 | Set All    | Entities    | -        | `PUT`     | Replaces the entire content of the collection with new entities.    |
 
 Extends [Indexer endpoint](indexer.md)
+
+## Usage
+
+TODO: Replace usage of `ContactEndpoint`
+
+=== "C#"
+
+    ```csharp
+    var contacts = new CollectionEndpoint<Contact>(client, "contacts");
+
+    // Read all entities in the collection
+    List<Contact> allContacts = await contacts.ReadAllAsync();
+
+    // Read a range of entities
+    List<Contact> someContacts = await contacts.ReadRangeAsync(new RangeItemHeaderValue(0, 49));
+
+    // Create a new entity
+    ContactEndpoint newContact = await contacts.CreateAsync(new Contact { Name = "John Doe" });
+
+    // Get an element by ID
+    ContactEndpoint contact = contacts["123"];
+    // or
+    ContactEndpoint contact = contacts.Get("123");
+
+    // Update multiple entities
+    await contacts.CreateAllAsync(new[] {
+        new Contact { Name = "Alice" },
+        new Contact { Name = "Bob" }
+    });
+
+    // Replace entire collection
+    await contacts.SetAllAsync(new[] {
+        new Contact { Name = "Charlie" },
+        new Contact { Name = "Diana" }
+    });
+    ```
+
+=== "Java"
+
+    ```java
+    CollectionEndpoint<Contact> contacts = new CollectionEndpoint<>(client, "contacts", Contact.class);
+
+    // Read all entities in the collection
+    List<Contact> allContacts = contacts.readAll();
+
+    // Read a range of entities
+    List<Contact> someContacts = contacts.readRange(Range.ofLength(0, 50));
+
+    // Create a new entity
+    ContactEndpoint newContact = contacts.create(new Contact("John Doe"));
+
+    // Get an element by ID
+    ContactEndpoint contact = contacts.get("123");
+
+    // Update multiple entities
+    contacts.createAll(List.of(
+        new Contact("Alice"),
+        new Contact("Bob")
+    ));
+
+    // Replace entire collection
+    contacts.setAll(List.of(
+        new Contact("Charlie"),
+        new Contact("Diana")
+    ));
+    ```
+
+=== "Kotlin"
+
+    ```kotlin
+    val contacts = CollectionEndpoint(client, "contacts", Contact::class.java)
+
+    // Read all entities in the collection
+    val allContacts = contacts.readAll()
+
+    // Read a range of entities
+    val someContacts = contacts.readRange(Range.ofLength(0, 50))
+
+    // Create a new entity
+    val newContact = contacts.create(Contact("John Doe"))
+
+    // Get an element by ID
+    val contact = contacts["123"]
+    // or
+    val contact = contacts.get("123")
+
+    // Update multiple entities
+    contacts.createAll(listOf(
+        Contact("Alice"),
+        Contact("Bob")
+    ))
+
+    // Replace entire collection
+    contacts.setAll(listOf(
+        Contact("Charlie"),
+        Contact("Diana")
+    ))
+    ```
+
+=== "TypeScript"
+
+    ```typescript
+    const contacts = new CollectionEndpoint<Contact>(client, "contacts");
+
+    // Read all entities in the collection
+    const allContacts = await contacts.readAll();
+
+    // Read a range of entities
+    const someContacts = await contacts.readRange({ from: 0, to: 49 });
+
+    // Create a new entity
+    const newContact = await contacts.create({ name: "John Doe" });
+
+    // Get an element by ID
+    const contact = contacts.get("123");
+
+    // Update multiple entities
+    await contacts.createAll([
+        { name: "Alice" },
+        { name: "Bob" }
+    ]);
+
+    // Replace entire collection
+    await contacts.setAll([
+        { name: "Charlie" },
+        { name: "Diana" }
+    ]);
+    ```

docs/endpoints/generic/element.md

@@ -9,3 +9,90 @@ Endpoint for an individual resource.
 | Set    | Entity | Entity  | `PUT`     | Sets/replaces the entity.                        |
 | Merge  | Entity | Entity  | `PATCH`   | Modifies the existing entity by merging changes. |
 | Delete | -      | -       | `DELETE`  | Deletes the element.                             |
+
+## Usage
+
+=== "C#"
+
+    ```csharp
+    var contact = new ElementEndpoint<Contact>(client, "contacts/123");
+
+    // Check if the element exists
+    bool exists = await contact.ExistsAsync();
+
+    // Read the entity
+    Contact entity = await contact.ReadAsync();
+
+    // Update the entire entity
+    await contact.SetAsync(new Contact { Name = "Jane Doe", Email = "jane@example.com" });
+
+    // Partially update the entity
+    await contact.MergeAsync(new { Email = "newemail@example.com" });
+
+    // Delete the element
+    await contact.DeleteAsync();
+    ```
+
+=== "Java"
+
+    ```java
+    ElementEndpoint<Contact> contact = new ElementEndpoint<>(client, "contacts/123", Contact.class);
+
+    // Check if the element exists
+    boolean exists = contact.exists();
+
+    // Read the entity
+    Contact entity = contact.read();
+
+    // Update the entire entity
+    contact.set(new Contact("Jane Doe", "jane@example.com"));
+
+    // Partially update the entity
+    Map<String, Object> updates = Map.of("email", "newemail@example.com");
+    contact.merge(updates);
+
+    // Delete the element
+    contact.delete();
+    ```
+
+=== "Kotlin"
+
+    ```kotlin
+    val contact = ElementEndpoint(client, "contacts/123", Contact::class.java)
+
+    // Check if the element exists
+    val exists = contact.exists()
+
+    // Read the entity
+    val entity = contact.read()
+
+    // Update the entire entity
+    contact.set(Contact("Jane Doe", "jane@example.com"))
+
+    // Partially update the entity
+    contact.merge(mapOf("email" to "newemail@example.com"))
+
+    // Delete the element
+    contact.delete()
+    ```
+
+=== "TypeScript"
+
+    ```typescript
+    const contact = new ElementEndpoint<Contact>(client, "contacts/123");
+
+    // Check if the element exists
+    const exists = await contact.exists();
+
+    // Read the entity
+    const entity = await contact.read();
+
+    // Update the entire entity
+    await contact.set({ name: "Jane Doe", email: "jane@example.com" });
+
+    // Partially update the entity
+    await contact.merge({ email: "newemail@example.com" });
+
+    // Delete the element
+    await contact.delete();
+    ```

docs/endpoints/generic/indexer.md

@@ -5,3 +5,57 @@ Endpoint that addresses child endpoints by ID.
 | Method | Input | Result   | HTTP Verb | Description                                                         |
 | ------ | ----- | -------- | --------- | ------------------------------------------------------------------- |
 | Get    | ID    | Endpoint | -         | Get an [Element endpoint](element.md) for a specific child element. |
+
+## Usage
+
+=== "C#"
+
+    ```csharp
+    var users = new IndexerEndpoint<UserEndpoint>(client, "users");
+
+    // Get a child endpoint by ID
+    UserEndpoint user = users["123"];
+    // or
+    UserEndpoint user = users.Get("123");
+
+    // Use the child endpoint
+    User userData = await user.ReadAsync();
+    ```
+
+=== "Java"
+
+    ```java
+    IndexerEndpoint<UserEndpoint> users = new IndexerEndpoint<>(client, "users", UserEndpoint.class);
+
+    // Get a child endpoint by ID
+    UserEndpoint user = users.get("123");
+
+    // Use the child endpoint
+    User userData = user.read();
+    ```
+
+=== "Kotlin"
+
+    ```kotlin
+    val users = IndexerEndpoint(client, "users", UserEndpoint::class.java)
+
+    // Get a child endpoint by ID
+    val user = users["123"]
+    // or
+    val user = users.get("123")
+
+    // Use the child endpoint
+    val userData = user.read()
+    ```
+
+=== "TypeScript"
+
+    ```typescript
+    const users = new IndexerEndpoint<UserEndpoint>(client, "users");
+
+    // Get a child endpoint by ID
+    const user = users.get("123");
+
+    // Use the child endpoint
+    const userData = await user.read();
+    ```