garydgregory commented on PR #499: URL: https://github.com/apache/httpcomponents-core/pull/499#issuecomment-2424160216
> > Hi @desiderantes I'd like to see all new public and protected elements come with Javadoc (with since tags). > > Besides a since tag, what else should the builder methods document? All other methods don't have a javadoc. I think it would be good to carry standard Javadoc tags like param, return, throws, whatever is appropriate for that element. For the description, I like to be able to understand why I'd use one thing versus another. In this case, a query is lile a get plus a body. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: dev-unsubscr...@hc.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@hc.apache.org For additional commands, e-mail: dev-h...@hc.apache.org
