move doc from notes into Javadoc