From 1ae2aa3c801e24a2fe9f4a9b8dad5b639e105c59 Mon Sep 17 00:00:00 2001
From: Keith Bray <keith.bray@rackspace.com>
Date: Tue, 24 Nov 2015 14:35:27 -0600
Subject: [PATCH] Documents languagepack uses cases

Change-Id: I4197774cc88be40f3b9664806ff5f226fd9a0511
Closes-Bug: #1325590
---
 doc/source/getting_started/index.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doc/source/getting_started/index.rst b/doc/source/getting_started/index.rst
index 0222046e9..40bc691fc 100644
--- a/doc/source/getting_started/index.rst
+++ b/doc/source/getting_started/index.rst
@@ -17,6 +17,17 @@ Overview
   $ solum app show <UUID/Name>
   $ curl <application_uri>
 
+Use Cases
+~~~~~~~~~
+A languagepack must exist in Solum, as every application deployed
+with Solum requires an association to a languagepack to run (even
+if the languagepack only implements a no-op). Languagepacks can be
+added to Solum in the following ways:
+
+1. Solum comes with pre-existing languagepacks
+2. Solum System Operator creates and adds languagepack(s) available for all users
+3. Solum User creates and adds languagepack(s) available only to that user
+
 Vagrant Demo Environment
 ------------------------