adding javadocs to for the new dynamic entity feature.