diff -r 4bd6f3bc6c64 -r 26513bd377b9 javaquery/api/src/main/java/org/apidesign/bck2brwsr/htmlpage/api/Property.java
--- a/javaquery/api/src/main/java/org/apidesign/bck2brwsr/htmlpage/api/Property.java	Mon Feb 18 12:26:16 2013 +0100
+++ b/javaquery/api/src/main/java/org/apidesign/bck2brwsr/htmlpage/api/Property.java	Fri Feb 22 08:59:40 2013 +0100
@@ -20,16 +20,36 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import java.util.List;
 
-/** Represents a property in a generated model of an HTML
- * {@link Page}.
+/** Represents a property. Either in a generated model of an HTML
+ * {@link Page} or in a class defined by {@link Model}.
  *
  * @author Jaroslav Tulach <jtulach@netbeans.org>
  */
 @Retention(RetentionPolicy.SOURCE)
 @Target({})
 public @interface Property {
+    /** Name of the property. Will be used to define proper getter and setter
+     * in the associated class.
+     * 
+     * @return valid java identifier
+     */
     String name();
+    
+    /** Type of the property. Can either be primitive type (like <code>int.class</code>,
+     * <code>double.class</code>, etc.), {@link String} or complex model
+     * class (defined by {@link Model} property).
+     * 
+     * @return the class of the property
+     */
     Class<?> type();
+    
+    /** Is this property an array of the {@link #type()} or a single value?
+     * If the property is an array, only its getter (returning mutable {@link List} of
+     * the boxed {@link #type()}).
+     * 
+     * @return true, if this is supposed to be an array of values.
+     */
     boolean array() default false;
 }