opencensus-java
opencensus-java copied to clipboard
Consider changing the Javadoc policy to allow omitting unnecessary param and return tags.
This is related to the discussion in https://github.com/census-instrumentation/opencensus-java/pull/485#discussion_r130210392. Javadocs written with the current style (https://github.com/census-instrumentation/opencensus-java/blob/master/CONTRIBUTING.md#javadoc) can sometimes clutter the documentation and hide the most relevant points.
Thanks for raising this. You captured my concern succinctly!