it was one of the issues open to have "more Javadoc for public methods" (I closed it as it's too open-ended) but I think it's worth it for a builder and any major interfaces we use.