Merge branch 'bootstrap-improved-documentation'

1 files changed, 30 insertions, 0 deletions

diff --git a/docs/security.md b/docs/security.md
new file mode 100644
index 0000000000..af2d8f5f3d
--- /dev/null
+++ b/docs/security.md
@@ -0,0 +1,30 @@
+# Mullvad VPN app security
+
+This document describes the security properties of the Mullvad VPN app. It describes it for all
+platforms and their differences.
+
+This document does not describe *how* we reach and uphold these properties, just what they are.
+See the [architecture](architecture.md) document for details on how this security is implemented.
+
+
+## App states
+
+### Disconnected
+
+### Connecting
+
+### Connected
+
+### Disconnecting
+
+### Blocked
+
+
+## Firewall
+
+The states above should probably explain what can and can't be reached in the different states.
+But we might need/want this section in case there is something that does not fit above.
+
+## DNS
+
+Where are DNS requests sent?