diff --git a/doc/issues.md b/doc/issues.md
new file mode 100644
index 0000000..ed8843a
--- /dev/null
+++ b/doc/issues.md
@@ -0,0 +1,19 @@
+# Issues
+
+## Error handling
+
+Some errors are being handled, some aren't, some are being handled
+partially and some errors (and/or their handling) might break the program
+before a proper return. some return values of library functions are being
+ignored altogether.
+
+## Context handling
+
+Context handling in it's current form relies on all
+context types to have a free() function stored
+on a specific place in the data structure.
+
+This will most likely result in a segfault anytime
+a new structure is being used that is not properly
+aligned.
+