Inconsistent order of sections in generated class documentation

XMLWordPrintable

    • Type: Bug
    • Resolution: Fixed
    • Priority: P4
    • 22
    • Affects Version/s: 22
    • Component/s: tools
    • None

      Two inconsistencies have been observed in the generated output.

      1. annotation types

      For an annotation type that defines fields as well as annotation members:
      the field summary appears after the annotation members summaries
      the field details appear before the annotation members details
      so the page is ordered:
         Optional Element Summary
         Field Summary
         Field Details
         Element Details

      2. Classes with JavaFX-style properties

      The existing order, for classes that have them, is
          Properties
          Nested Classes
          Fields

      In general, the order of elements on a page is
         nested classes
         field-like members
         method-like members

      --

      This suggests that nested classes should appear before properties, and that the same general order should apply to both summary tables and detail lists.

            Assignee:
            Jonathan Gibbons
            Reporter:
            Jonathan Gibbons
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: