Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8205590

API Documentation should include one more tab for "added methods"

XMLWordPrintable

      A DESCRIPTION OF THE PROBLEM :
      Q?: How will you know which methods NavigableSet (for example) adds to its parent SortedSet, because of which its suggested name should be NavigableSet?

      On Page
      https://docs.oracle.com/javase/8/docs/api/java/util/NavigableSet.html

      We have three tabs "All Methods", "Instance Methods" and "Abstract Methods" but none "Added Methods".

      Definitively if we are giving the name Navigable, it is because it might be adding Navigable Capabilities , but what are those capabilities?
      Its documentation responsibility to list those unique capabilities that are new from its parent SortedSet.
      What is the Need? Because i go to documentation to learn and understand every class and interface, but not just to list all methods. If i would like to list all methods which i can use, which i might, when may be i am actually developing but not basically learning mode, i will probably already be in an editor like net-beans, and i will press "." to list all choices. But will prefer to go to documentation page when i am in learning mode to understand relative differences in all classes.



            Unassigned Unassigned
            webbuggrp Webbug Group
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: