From 53c6c5cfb3426e5cc7f4ad3a1250d8a1e51a1bcc Mon Sep 17 00:00:00 2001
From: Eric Tune <etune@google.com>
Date: Thu, 30 Apr 2015 12:41:21 -0700
Subject: [PATCH] Document session affinity option.

Closes #2867
---
 docs/services.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/services.md b/docs/services.md
index e582c245799..efd6f10e45d 100644
--- a/docs/services.md
+++ b/docs/services.md
@@ -109,6 +109,9 @@ appropriate backend without the clients knowing anything about Kubernetes or
 
 ![Services overview diagram](services_overview.png)
 
+By default, the choice of backend is random.  Client-IP-based session affinity
+can be selected by setting `service.spec.sessionAffinity` to  `"ClientIP"`.
+
 ### Why not use round-robin DNS?
 
 A question that pops up every now and then is why we do all this stuff with