add section on security

diff --git a/doc/design/generic_p2p_transport.mdwn b/doc/design/generic_p2p_transport.mdwn
index 32997b382a6a9b640c7a900fe2cf329ece543dec..e362c70668ce1ec241b66507c807577e5d7eb346 100644 (file)
--- a/doc/design/generic_p2p_transport.mdwn
+++ b/doc/design/generic_p2p_transport.mdwn
@@ -50,3 +50,11 @@ P2P network and dummys it up by symlinking unix socket files together,
 its skeleton should be a good starting point.
 
 [[special_remotes/p2p/git-annex-p2p-unix-sockets]]
+
+## security
+
+This is only as secure as the underlying P2P network.
+It is really designed with P2P networks in mind that are fully encrypted,
+and that use cryptography to validate the identities of peers. 
+
+See the security discussion on [[special_remotes/p2p]].