Update docs regarding IDs and transactions

docs/docs/crud.md

@@ -48,7 +48,7 @@ For the examples below, we assume that we have a collection `Recipe` defined as
 ```dart
 @collection
 class Recipe {
-  Id? id;
+  late int id;
 
   String? name;
 
@@ -115,7 +115,7 @@ final favorites = await isar.recipes.filter()
 It's finally time to modify our collection! To create, update, or delete objects, use the respective operations wrapped in a write transaction:
 
 ```dart
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   final recipe = await isar.recipes.get(123)
 
   recipe.isFavorite = false;
@@ -135,11 +135,12 @@ If the id field is `null` or `Isar.autoIncrement`, Isar will use an auto-increme
 
 ```dart
 final pancakes = Recipe()
+  ..id = isar.recipes.autoIncrement()
   ..name = 'Pancakes'
   ..lastCooked = DateTime.now()
   ..isFavorite = true;
 
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   await isar.recipes.put(pancakes);
 })
 ```
@@ -149,7 +150,7 @@ Isar will automatically assign the id to the object if the `id` field is non-fin
 Inserting multiple objects at once is just as easy:
 
 ```dart
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   await isar.recipes.putAll([pancakes, pizza]);
 })
 ```
@@ -161,7 +162,7 @@ Both creating and updating works with `collection.put(object)`. If the id is `nu
 So if we want to unfavorite our pancakes, we can do the following:
 
 ```dart
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   pancakes.isFavorite = false;
   await isar.recipes.put(pancakes);
 });
@@ -172,7 +173,7 @@ await isar.writeTxn(() async {
 Want to get rid of an object in Isar? Use `collection.delete(id)`. The delete method returns whether an object with the specified id was found and deleted. If you want to delete the object with id `123`, for example, you can do:
 
 ```dart
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   final success = await isar.recipes.delete(123);
   print('Recipe deleted: $success');
 });
@@ -181,7 +182,7 @@ await isar.writeTxn(() async {
 Similarly to get and put, there is also a bulk delete operation that returns the number of deleted objects:
 
 ```dart
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   final count = await isar.recipes.deleteAll([1, 2, 3]);
   print('We deleted $count recipes');
 });
@@ -190,7 +191,7 @@ await isar.writeTxn(() async {
 If you don't know the ids of the objects you want to delete, you can use a query:
 
 ```dart
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   final count = await isar.recipes.filter()
     .isFavoriteEqualTo(false)
     .deleteAll();

docs/docs/de/crud.md

@@ -45,7 +45,7 @@ Den folgenden Beispielen liegt die Collection `Recipe` zugrunde, die wie folgt d
 ```dart
 @collection
 class Recipe {
-  Id? id;
+  late int id;
 
   String? name;
 
@@ -112,7 +112,7 @@ final favourites = await recipes.filter()
 Jetzt ist es endlich an der Zeit, unsere Collection zu verändern! Um Objekte zu erstellen, zu aktualisieren oder zu löschen, rufe die entsprechenden Operationen innerhalb einer Schreibtransaktion auf:
 
 ```dart
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   final recipe = await recipes.get(123)
 
   recipe.isFavorite = false;
@@ -132,11 +132,12 @@ Wenn das ID-Feld `null` oder `Isar.autoIncrement` ist, verwendet Isar eine autom
 
 ```dart
 final pancakes = Recipe()
+  ..id = isar.recipes.autoIncrement()
   ..name = 'Pancakes'
   ..lastCooked = DateTime.now()
   ..isFavorite = true;
 
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   await recipes.put(pancakes);
 })
 ```
@@ -146,7 +147,7 @@ Ist das ID-Feld nicht-final, weist Isar die generierte ID automatisch dem Objekt
 Das Erstellen von mehreren Objekten auf einmal ist genauso einfach:
 
 ```dart
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   await recipes.putAll([pancakes, pizza]);
 })
 ```
@@ -158,7 +159,7 @@ Sowohl das Erstellen als auch das Aktualisieren funktioniert mit `collection.put
 Wenn wir also Pfannkuchen nicht mehr mögen, können wir Folgendes tun:
 
 ```dart
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   pancakes.isFavorite = false;
   await recipes.put(recipe);
 });
@@ -169,7 +170,7 @@ await isar.writeTxn(() async {
 Willst du ein Objekt in Isar loswerden? Verwende `collection.delete(id)`. Die delete-Methode gibt zurück, ob ein Objekt mit der angegebenen ID gefunden und gelöscht wurde. Lass uns z.B. das Objekt mit der ID `123` löschen:
 
 ```dart
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   final success = await recipes.delete(123);
   print('Recipe deleted: $success');
 });
@@ -178,7 +179,7 @@ await isar.writeTxn(() async {
 Ähnlich wie bei `get()` und `put()` gibt es auch einen Massenlöschvorgang, der die Anzahl der gelöschten Objekte zurückgibt:
 
 ```dart
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   final count = await recipes.deleteAll([1, 2, 3]);
   print('We deleted $count recipes');
 });
@@ -187,7 +188,7 @@ await isar.writeTxn(() async {
 Wenn du die IDs der zu löschenden Objekte nicht kennst ist es auch möglich eine Abfrage zu verwenden:
 
 ```dart
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   final count = await recipes.filter()
     .isFavoriteEqualTo(false)
     .deleteAll();

docs/docs/de/indexes.md

@@ -15,7 +15,7 @@ Zum Beispiel ist diese `Product`-Collection komplett unsortiert.
 ```dart
 @collection
 class Product {
-  Id? id;
+  late int id;
 
   late String name;
 
@@ -50,7 +50,7 @@ Um die Leistung dieser Abfrage zu verbessern, indizieren wir die Eigenschaft `pr
 ```dart
 @collection
 class Product {
-  Id? id;
+  late int id;
 
   late String name;
 
@@ -110,7 +110,7 @@ Ein eindeutiger Index stellt sicher, dass der Index keine doppelten Werte enthä
 ```dart
 @collection
 class User {
-  Id? id;
+  late int id;
 
   @Index(unique: true)
   late String username;
@@ -147,7 +147,7 @@ Manchmal ist es nicht von Vorteil einen Fehler zu verursachen, wenn eine Eindeut
 ```dart
 @collection
 class User {
-  Id? id;
+  late int id;
 
   @Index(unique: true, replace: true)
   late String username;
@@ -206,7 +206,7 @@ Alle Indizes auf `String`- und `List<String>`-Eigenschaften beachten standardmä
 ```dart
 @collection
 class Person {
-  Id? id;
+  late int id;
 
   @Index(caseSensitive: false)
   late String name;
@@ -255,7 +255,7 @@ Es ist vermutlich am besten mit einem Beispiel zu starten. Wir erstellen eine Pe
 ```dart
 @collection
 class Person {
-  Id? id;
+  late int id;
 
   late String name;
 
@@ -320,7 +320,7 @@ Zu sinnvollen Anwendungen für Mehrfach-Indizes zählen das Indizieren einer Lis
 ```dart
 @collection
 class Product {
-  Id? id;
+  late int id;
 
   late String description;
 

docs/docs/de/links.md

@@ -2,6 +2,8 @@
 title: Links
 ---
 
+> ⚠️ Links are currently not supported in Isar v4
+
 # Links
 
 Links ermöglichen es dir Verhältnisse zwischen Objekten, wie z.B. dem Autor (Benutzer) eines Kommentars, auszudrücken. Du kannst `1:1`, `1:n`, `n:m` Verhältnisse mit Isar-Links modellieren. Links zu nutzen ist unpraktischer als eingebettete Objekte zu benutzen, und du solltest eingebettete Objekte, wann immer möglich, verwenden.
@@ -23,14 +25,14 @@ Für nicht-Web-Ziele werden Links automatisch geladen, wenn du sie zum ersten Ma
 ```dart
 @collection
 class Teacher {
-  Id? id;
+  late int id;
 
   late String subject;
 }
 
 @collection
 class Student {
-  Id? id;
+  late int id;
 
   late String name;
 
@@ -49,7 +51,7 @@ final linda = Student()
   ..name = 'Linda'
   ..teacher.value = mathTeacher;
 
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   await isar.students.put(linda);
   await isar.teachers.put(mathTeacher);
   await linda.teachers.save();
@@ -91,7 +93,7 @@ Intern werden `IsarLink` und `IsarLinks` auf die gleiche Weise dargestellt. Wir
 ```dart
 @collection
 class Student {
-  Id? id;
+  late int id;
 
   late String name;
 
@@ -113,7 +115,7 @@ print(linda.teachers); // {Teacher('Math')}
 
 linda.teachers.add(biologyTeacher);
 
-await isar.writeTxn(() async {
+await isar.writeAsync((isar) async {
   await linda.teachers.save();
 });
 

docs/docs/de/queries.md

@@ -26,7 +26,7 @@ Wir benutzen das folgende Modell für die Beispiele weiter unten:
 ```dart
 @collection
 class Shoe {
-  Id? id;
+  late int id;
 
   int? size;
 
@@ -199,7 +199,7 @@ Abfragen können sogar auf Listen gestellt werden:
 
 ```dart
 class Tweet {
-  Id? id;
+  late int id;
 
   String? text;
 
@@ -236,7 +236,7 @@ Eingebettete Objekte sind eines von Isars nützlichsten Features. Sie können se
 ```dart
 @collection
 class Car {
-  Id? id;
+  late int id;
 
   Brand? brand;
 }
@@ -281,14 +281,14 @@ Beachte, dass Link-Abfragen teuer sein können, weil Isar die verlinkten Objekte
 ```dart
 @collection
 class Teacher {
-  Id? id;
+  late int id;
 
   late String subject;
 }
 
 @collection
 class Student {
-  Id? id;
+  late int id;
 
   late String name;
 
@@ -340,7 +340,7 @@ Lass uns Indizes zu der Schuh-Collection hinzufügen:
 ```dart
 @collection
 class Shoe with IsarObject {
-  Id? id;
+  late int id;
 
   @Index()
   Id? size;

docs/docs/de/recipes/data_migration.md

@@ -18,7 +18,7 @@ Version 1:
 ```dart
 @collection
 class User {
-  Id? id;
+  late int id;
 
   late String name;
 
@@ -30,7 +30,7 @@ Version 2:
 ```dart
 @collection
 class User {
-  Id? id;
+  late int id;
 
   late String name;
 

docs/docs/de/recipes/full_text_search.md

@@ -24,7 +24,7 @@ Bauen wir den grundlegendsten Volltext-Index:
 
 ```dart
 class Message {
-  Id? id;
+  late int id;
 
   late String content;
 
@@ -67,7 +67,7 @@ Das ist kinderleicht! Wir können unseren Index so ändern, dass er auch Präfix
 
 ```dart
 class Post {
-  Id? id;
+  late int id;
 
   late String title;
 
@@ -95,7 +95,7 @@ Klar! Wir werden einen Trick verwenden, um `.endsWith()` verwenden zu können:
 
 ```dart
 class Post {
-    Id? id;
+    late int id;
 
     late String title;