Buenos días, sería interesante que en la documentación de las clases se indicara para qué es apropiada cada una (best practices de aplicación) y un ejemplo de su uso (de los parámetros a pasar o sus valores por defecto si no hay).
Liferay is an open source project and welcomes submissions by the community. Javadocs are missing and/or incomplete, but if you write some they'd surely integrate it...
