kinow commented on a change in pull request #144: [COLLECTIONS-757] Update the
JavaDoc of the BidiMap
URL:
https://github.com/apache/commons-collections/pull/144#discussion_r399619466
##########
File path:
src/main/java/org/apache/commons/collections4/bidimap/DualLinkedHashBidiMap.java
##########
@@ -26,9 +26,9 @@
import org.apache.commons.collections4.BidiMap;
/**
- * Implementation of {@code BidiMap} that uses two {@code LinkedHashMap}
instances.
+ * Implementation of {@link BidiMap} that uses two {@link LinkedHashMap}
instances.
Review comment:
This might have been intentional? Some people prefer to avoid adding too
many links in the Javadoc (forgot where I saw a presentation about that, but it
was in some guide for writing Javadocs where the author mentioned to keep the
number of links low, so users are not distracted).
----------------------------------------------------------------
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.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
With regards,
Apache Git Services
