Better class docs for new models: Busy, FreeBusy, FreeBusySpace.

Author: christophermark

src/main/java/com/robinpowered/sdk/model/Busy.java

@@ -4,6 +4,13 @@
 
 import java.util.List;
 
+/**
+ * A period of time that a {@link Space} is unavailable for. <p>
+ *
+ * Contains a grouping of all events that occur within this unavailable block of time. When the
+ * gap between events is shorter than the duration requested, the events will be grouped
+ * together in a single Busy container.
+ */
 public class Busy {
 
     /**
@@ -26,6 +33,13 @@ public class Busy {
      * Methods
      */
 
+    /**
+     * Constructor.
+     *
+     * @param from The start of the busy period.
+     * @param to The end of the busy period.
+     * @param events The {@link Event Events} occurring throughout the busy period.
+     */
     public Busy(DateTime from, DateTime to, List<SimpleEvent> events) {
         this.from = from;
         this.to = to;

src/main/java/com/robinpowered/sdk/model/FreeBusy.java

@@ -2,8 +2,16 @@
 
 import java.util.List;
 
+/**
+ * An interface for Free-busy information returned for different models.
+ */
 public interface FreeBusy {
 
+    /**
+     * Returns a list of {@link Busy} intervals for which the given model is unavailable.
+     *
+     * @return A list of {@link Busy} intervals.
+     */
     List<Busy> getBusy();
 
 }

src/main/java/com/robinpowered/sdk/model/FreeBusySpace.java

@@ -2,6 +2,14 @@
 
 import java.util.List;
 
+/**
+ * Free-busy information returned for a given {@link Space} across a requested period of time. <p>
+ *
+ * Free-busy information describes the availability of a {@link Space} throughout a period of time
+ * by returning a set of {@link Busy} intervals which contain all events which overlap the requested
+ * period of time. The given space is available for the requested duration during any gaps between
+ * {@link Busy} models.
+ */
 public class FreeBusySpace implements ApiResponseModel, FreeBusy {
 
     /**
@@ -35,7 +43,7 @@ public String getMimeType() {
         return MIME_TYPE;
     }
 
-    public boolean isHasPresence() {
+    public boolean hasPresence() {
         return hasPresence;
     }