Merge pull request #8289 from krousey/api_conversion_doc

docs/api.md

@@ -41,7 +41,7 @@ Some important differences between v1beta1/2 and v1beta3:
 * `name`, `labels`, `annotations`, and other metadata are now nested in a map called `metadata`
 * `desiredState` is now called `spec`, and `currentState` is now called `status`
 * `/minions` has been moved to `/nodes`, and the resource has kind `Node`
-* The namespace is required (for all namespaced resources) and has moved from a URL parameter to the path: `/api/v1beta3/namespaces/{namespace}/{resource_collection}/{resource_name}`
+* The namespace is required (for all namespaced resources) and has moved from a URL parameter to the path: `/api/v1beta3/namespaces/{namespace}/{resource_collection}/{resource_name}`. If you were not using a namespace before, use `default` here.
 * The names of all resource collections are now lower cased - instead of `replicationControllers`, use `replicationcontrollers`.
 * To watch for changes to a resource, open an HTTP or Websocket connection to the collection query and provide the `?watch=true` query parameter along with the desired `resourceVersion` parameter to watch from.
 * The `labels` query parameter has been renamed to `label-selector`.