Deprecate KubernetesAutoServiceRegistration and add service registry docs (#349)

* Deprecate KubernetesAutoServiceRegistration

* Document service registry in kubernetes.  Fixes #348

docs/src/main/asciidoc/service-registry.adoc

@@ -0,0 +1,5 @@
+== Service Registry Implementation
+
+In Kubernetes service registration is controlled by the platform, the application itself does not control
+registration as it may do in other platforms.  For this reason using `spring.cloud.service-registry.auto-registration.enabled`
+or setting `@EnableDiscoveryClient(autoRegister=false)` will have no effect in Spring Cloud Kubernetes.

docs/src/main/asciidoc/spring-cloud-kubernetes.adoc

@@ -25,6 +25,8 @@ include::leader-election.adoc[]
 
 include::security-service-accounts.adoc[]
 
+include::service-registry.adoc[]
+
 include::examples.adoc[]
 
 include::other-resources.adoc[]

spring-cloud-kubernetes-discovery/src/main/java/org/springframework/cloud/kubernetes/registry/KubernetesAutoServiceRegistration.java

@@ -36,6 +36,8 @@ import org.springframework.core.Ordered;
  *
  * @author Mauricio Salatino
  */
+@Deprecated
+//TODO Remove this class in 2.x as it is not used or necessary in Kubernetes
 public class KubernetesAutoServiceRegistration
 		implements AutoServiceRegistration, SmartLifecycle, Ordered {