From 09b5a49ec7827531690348b4bd14d4c83fc1bcd8 Mon Sep 17 00:00:00 2001
From: steveperry-53 <stevepe@google.com>
Date: Mon, 28 Nov 2016 18:23:59 -0800
Subject: [PATCH] Expanded style guidance for API objects.

---
 docs/contribute/style-guide.md | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/docs/contribute/style-guide.md b/docs/contribute/style-guide.md
index 219d62560d..1a23c7fac3 100644
--- a/docs/contribute/style-guide.md
+++ b/docs/contribute/style-guide.md
@@ -16,15 +16,26 @@ docs, follow the instructions on
 
 ## Documentation formatting standards
 
-### Capitalize API objects
+### Use Camel Case for API objects
 
-Capitalize the names of API objects. Refer to API objects without saying
-"object."
+When you refer to an API object, use the same uppercase and lowercase letters
+that are used in the actual object name. Typically, the names of API
+objects use
+[camel case](https://en.wikipedia.org/wiki/Camel_case).
+
+Don't split the API object name into separate words. For example, use
+PodTemplateList, not Pod Template List.
+
+Refer to API objects without saying "object," unless omitting "object"
+leads to an awkward construction.
 
 <table>
   <tr><th>Do</th><th>Don't</th></tr>
   <tr><td>The Pod has two Containers.</td><td>The pod has two containers.</td></tr>
   <tr><td>The Deployment is responsible for ...</td><td>The Deployment object is responsible for ...</td></tr>
+  <tr><td>A PodList is a list of Pods.</td><td>A Pod List is a list of pods.</td></tr>
+  <tr><td>The two ContainerPorts ...</td><td>The two ContainerPort objects ...</td></tr>
+  <tr><td>The two ContainerStateTerminated objects ...</td><td>The two ContainerStateTerminateds ...</td></tr>
 </table>
 
 ### Use angle brackets for placeholders