added some javadoc for (preliminary) improved component metadata rules api