improved javadocs
improved javadocs

Change-Id: I75cf104b05ed361ced7f17b20cebd98cc3825d5c

peterl1084/framework,kironapublic/vaadin,kironapublic/vaadin,Legioth/vaadin,asashour/framework,kironapublic/vaadin,Darsstar/framework,jdahlstrom/vaadin.react,mstahv/framework,jdahlstrom/vaadin.react,Legioth/vaadin,peterl1084/framework,asashour/framework,peterl1084/framework,asashour/framework,Darsstar/framework,jdahlstrom/vaadin.react,mstahv/framework,Darsstar/framework,jdahlstrom/vaadin.react,Darsstar/framework,Legioth/vaadin,jdahlstrom/vaadin.react,peterl1084/framework,mstahv/framework,Legioth/vaadin,Darsstar/framework,peterl1084/framework,asashour/framework,mstahv/framework,kironapublic/vaadin,asashour/framework,Legioth/vaadin,mstahv/framework,kironapublic/vaadin