diff --git a/src/main/java/org/springframework/cloud/client/discovery/DiscoveryClient.java b/src/main/java/org/springframework/cloud/client/discovery/DiscoveryClient.java
index 0ad2bbfd..285876cf 100644
--- a/src/main/java/org/springframework/cloud/client/discovery/DiscoveryClient.java
+++ b/src/main/java/org/springframework/cloud/client/discovery/DiscoveryClient.java
@@ -21,15 +21,15 @@ import java.util.List;
 import org.springframework.cloud.client.ServiceInstance;
 
 /**
- * DiscoveryClient represents operations commonly available to Discovery service
- * such as Netflix Eureka or consul.io
+ * DiscoveryClient represents operations commonly available to Discovery service such as
+ * Netflix Eureka or consul.io
  * @author Spencer Gibb
  */
 public interface DiscoveryClient {
 
 	/**
 	 * A human readable description of the implementation, used in HealthIndicator
-	 * @return
+	 * @return the description
 	 */
 	public String description();
 
@@ -39,14 +39,14 @@ public interface DiscoveryClient {
 	public ServiceInstance getLocalServiceInstance();
 
 	/**
-	 * Get all ServiceInstance's associated with a particular serviceId
+	 * Get all ServiceInstances associated with a particular serviceId
 	 * @param serviceId the serviceId to query
 	 * @return a List of ServiceInstance
 	 */
 	public List<ServiceInstance> getInstances(String serviceId);
 
 	/**
-	 * @return all known service id's
+	 * @return all known service ids
 	 */
 	public List<String> getServices();