Improve javadoc for root annotations

Related to #765