diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b6b5a6e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# FabAccess API
+
+## Code generation bugs under c#
+When returning an Interface it may be required to append a dummy valueto work around a c# code generation bug.
+
+```diff
+- whoami @4 () -> ( you :Api.User );
++ whoami @4 () -> ( you :Api.User, dummy :UInt8 = 0  );
+```