Document the minimum Xss requirement

Christopher Frost · Christopher Frost · commit f20749099750 · 2015-09-25T18:25:21.000+01:00
As described in the GitHub issue, this commit adds documentation about the minimum stack value that may prevent JRE startup. This will only occur should the use edit the default configuration. Close cloudfoundry#228 [#103782484]
diff --git a/docs/jre-open_jdk_jre.md b/docs/jre-open_jdk_jre.md
@@ -38,7 +38,9 @@ To add custom SSL certificates, add your `cacerts` file to `resources/open_jdk_j
 ### Memory
 The total available memory is specified when an application is pushed as part of it's configuration. The Java buildpack uses this value to control the JRE's use of various regions of memory. The JRE memory settings can be influenced by configuring the `memory_sizes`, `memory_heuristics`, `memory_initials` and/or `stack_threads` mappings.
 
-Note: if the total available memory is scaled up or down, the Java buildpack will re-calculate the JRE memory settings the next time the application is started.
+Note: If the total available memory is scaled up or down, the Java buildpack will re-calculate the JRE memory settings the next time the application is started.
+
+Note: If setting an initial Stack size, depending on the version of Java and the operating system used by Cloud Foundry the JRE will require a minimum `-Xss` value. This tends to be between `100k` and `250k`.
 
 #### Memory Sizes
 The following optional properties may be specified in the `memory_sizes` mapping.
diff --git a/docs/jre-oracle_jre.md b/docs/jre-oracle_jre.md
@@ -46,7 +46,9 @@ To add custom SSL certificates, add your `cacerts` file to `resources/oracle_jre
 ### Memory
 The total available memory is specified when an application is pushed as part of it's configuration. The Java buildpack uses this value to control the JRE's use of various regions of memory. The JRE memory settings can be influenced by configuring the `memory_sizes`, `memory_heuristics`, `memory_initials` and/or `stack_threads` mappings.
 
-Note: if the total available memory is scaled up or down, the Java buildpack will re-calculate the JRE memory settings the next time the application is started.
+Note: If the total available memory is scaled up or down, the Java buildpack will re-calculate the JRE memory settings the next time the application is started.
+
+Note: If setting an initial Stack size, depending on the version of Java and the operating system used by Cloud Foundry the JRE will require a minimum `-Xss` value. This tends to be between `100k` and `250k`.
 
 #### Memory Sizes
 The following optional properties may be specified in the `memory_sizes` mapping.
