ACE-4744 javadoc and cleanup

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@119697 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/traitextender/Extensible.java

@@ -16,9 +16,25 @@
  * You should have received a copy of the GNU Lesser General Public License
  * along with Alfresco. If not, see http://www.gnu.org/licenses/.
  */
+
 package org.alfresco.traitextender;
 
-
+/**
+ * An {@link Extensible} object exposes a set of {@link Trait}s as
+ * {@link ExtendedTrait}s objects.<br>
+ * An {@link ExtendedTrait} is an association between a {@link Trait} exposing
+ * object and several extension objects.<br>
+ * The actual {@link Trait}s and associated extensions provided by an
+ * {@link Extensible} object are given by its {@link ExtensionPoint} handling
+ * strategy and by the current set of registered extensions (see
+ * {@link Extender}).<br>
+ * The exposed {@link Trait}s can be thought of as parts of an object's
+ * interface that will be exposed to an extension. Upon the extension invocation
+ * the given trait instances will be made available to their corresponding
+ * extensions.
+ *
+ * @author Bogdan Horje
+ */
 public interface Extensible
 {
     <T extends Trait> ExtendedTrait<T> getTrait(Class<? extends T> traitAPI);