Could we add javadoc to all of these annotations, even if it's only pointing to the README?