From 0bca4bd4abbef7c236051dfc28d171c239a7cb30 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Thu, 27 Oct 2022 18:17:14 +0200
Subject: [PATCH] feat(dotnet): add "magic methods" notes

---
 docs/dotnet/C#/C#.md | 27 ++++++++++++---------------
 1 file changed, 12 insertions(+), 15 deletions(-)

diff --git a/docs/dotnet/C#/C#.md b/docs/dotnet/C#/C#.md
index 15d49dd..e2ef3fb 100644
--- a/docs/dotnet/C#/C#.md
+++ b/docs/dotnet/C#/C#.md
@@ -2922,22 +2922,19 @@ In this case, the method must also be declared as `static`.
 private static extern void AVIFileInit();
 ```
 
-The `LibraryImport` attribute can be used to import external code and have the source generator handle the marshalling for the annotated function.
+## Magic Methods
 
-> **Note**: The source generator will still use the `DllImport` attribute in the generated code.
+Methods needed to implement a behaviour which do not need an interface to work. The methods **must** be named _appropriately_ and have the  correct _return type_.
+
+### Enumerable
 
 ```cs
-// before
-public static class Native
-{
-    [DllImport(nameof(Native), CharSet = CharSet.Unicode)]
-    public extern static string ToLower(string str);
-}
-
-// after
-public static class Native
-{
-    [LibraryImport(nameof(Native), StringMarshalling = StringMarshalling.Utf16)]
-    public static partial string ToLower(string str);
-}
+public bool MoveNext(/* ... */);
+public T Current { get; }
+```
+
+### Awaitable
+
+```cs
+public TaskAwaiter GetAwaiter(/* ... */);
 ```