im flexible on where javadoc is mandatory/optional/etc. mainly just consistency with any existing standard we have if any -- we can discuss offline