diff --git a/docs/interop.txt b/docs/interop.txt
new file mode 100644
index 0000000..2048066
--- /dev/null
+++ b/docs/interop.txt
@@ -0,0 +1,9 @@
+api needs to facilitate easy interoperability with other languages and tools,
+for that certain steps are taken:
+
+* number of public api calls is kept at the minimum
+* procedure signatures can only use basic types, no aggregates, with exception of Vec/Matrix types and alike,
+  with no expectation on new additions (see /include/twn_types.h)
+* /include/twn_game_api.json file is hand-kept with a schema to aid automatic generation and other tooling
+
+one of main inspirations for that is opengl model