rest-api-standards.markdown

@@ -14,6 +14,8 @@
 
 ### Standards for KD Core API
 
+_Note:_ __due to the nature of the `bundle` architecture, our resources are namespaced by design. This can lead to the acceptable consequence of having a route that is structured like `namespace/resources` or `namespace-is-the-resource`.
+
 
 | HTTP     | Route                                     | Action                    |
 | -------- | ----------------------                    | ------------------------- |