diff --git a/docs/manual/src/docbook/technical-overview.xml b/docs/manual/src/docbook/technical-overview.xml
index 0d62d41c10..41d3d8d6f6 100644
--- a/docs/manual/src/docbook/technical-overview.xml
+++ b/docs/manual/src/docbook/technical-overview.xml
@@ -336,7 +336,13 @@ Successfully authenticated. Security context contains: \
All you need to do is write a filter (or equivalent) that reads the third-party user
information from a location, build a Spring Security-specific
Authentication object, and put it into the
- SecurityContextHolder.
+ SecurityContextHolder. In this case you also need to think
+ about things which are normally taken care of automatically by the built-in authentication
+ infrastructure. For example, you might need to pre-emptively create an HTTP session to
+ cache the context between requests,
+ before you write the response to the clientIt isn't possible to create a session once the
+ response has been committed..
+
If you're wondering how the AuthenticationManager
manager is implemented in a real world example, we'll look at that in the core services