Details

    • Type: Sub-task Sub-task
    • Status: Closed
    • Priority: Minor Minor
    • Resolution: Fixed
    • Affects Version/s: 10.7.1.1
    • Fix Version/s: 10.8.2.2, 10.9.1.0
    • Component/s: Documentation
    • Labels:
      None

      Description

      Many tables in the Derby documentation appear abruptly, with conceptual prose followed immediately by a table (with or without a title). Here are some examples:

      http://db.apache.org/derby/docs/dev/devguide/devguide-single.html#tdevupgradedb
      http://db.apache.org/derby/docs/dev/adminguide/adminguide-single.html#cadminappsclient
      http://db.apache.org/derby/docs/dev/ref/ref-single.html#rrefjdbc27734

      There is no specific accessibility requirement that tables be properly introduced, but many companies' technical writing style guides require or strongly recommend it. Moreover, the WCAG guidelines have the following statements (http://www.w3.org/TR/WCAG10/#context-and-orientation):

      "Content developers should make content understandable and navigable. This includes not only making the language clear and simple, but also providing understandable mechanisms for navigating within and between pages. Providing navigation tools and orientation information in pages will maximize accessibility and usability. ... The theme of making content understandable and navigable is addressed primarily in guidelines 12 to 14."

      Therefore, in the interest of accessibility, each table should be introduced with some indication that a table is coming.

      Further details will be provided in comments.

      1. DERBY-5184-admin.diff
        21 kB
        Kim Haase
      2. DERBY-5184-admin.stat
        0.3 kB
        Kim Haase
      3. DERBY-5184-admin.zip
        21 kB
        Kim Haase
      4. DERBY-5184-dev.diff
        28 kB
        Kim Haase
      5. DERBY-5184-dev.stat
        0.5 kB
        Kim Haase
      6. DERBY-5184-dev.zip
        34 kB
        Kim Haase
      7. DERBY-5184-gs.diff
        77 kB
        Kim Haase
      8. DERBY-5184-gs.stat
        0.6 kB
        Kim Haase
      9. DERBY-5184-gs.zip
        42 kB
        Kim Haase
      10. DERBY-5184-ref.diff
        217 kB
        Kim Haase
      11. DERBY-5184-ref.stat
        2 kB
        Kim Haase
      12. DERBY-5184-ref.zip
        145 kB
        Kim Haase
      13. DERBY-5184-tools.diff
        31 kB
        Kim Haase
      14. DERBY-5184-tools.stat
        0.3 kB
        Kim Haase
      15. DERBY-5184-tools.zip
        18 kB
        Kim Haase
      16. DERBY-5184-tun.diff
        13 kB
        Kim Haase
      17. DERBY-5184-tun.stat
        0.2 kB
        Kim Haase
      18. DERBY-5184-tun.zip
        15 kB
        Kim Haase
      19. JDBCTypePrinter.java
        3 kB
        Rick Hillegas

        Issue Links

          Activity

          Kim Haase created issue -
          Rick Hillegas made changes -
          Field Original Value New Value
          Attachment JDBCTypePrinter.java [ 12477001 ]
          Kim Haase made changes -
          Link This issue relates to DERBY-2623 [ DERBY-2623 ]
          Kim Haase made changes -
          Link This issue relates to DERBY-2625 [ DERBY-2625 ]
          Kim Haase made changes -
          Attachment DERBY-5184-gs.diff [ 12477146 ]
          Attachment DERBY-5184-gs.stat [ 12477147 ]
          Attachment DERBY-5184-gs.zip [ 12477148 ]
          Kim Haase made changes -
          Attachment DERBY-5184-dev.diff [ 12477149 ]
          Attachment DERBY-5184-dev.stat [ 12477150 ]
          Attachment DERBY-5184-dev.zip [ 12477151 ]
          Kim Haase made changes -
          Attachment DERBY-5184-admin.diff [ 12477152 ]
          Attachment DERBY-5184-admin.stat [ 12477153 ]
          Attachment DERBY-5184-admin.zip [ 12477154 ]
          Kim Haase made changes -
          Attachment DERBY-5184-ref.diff [ 12477155 ]
          Attachment DERBY-5184-ref.stat [ 12477156 ]
          Attachment DERBY-5184-ref.zip [ 12477157 ]
          Kim Haase made changes -
          Attachment DERBY-5184-tools.diff [ 12477158 ]
          Attachment DERBY-5184-tools.stat [ 12477159 ]
          Attachment DERBY-5184-tools.zip [ 12477160 ]
          Kim Haase made changes -
          Attachment DERBY-5184-tun.diff [ 12477163 ]
          Attachment DERBY-5184-tun.stat [ 12477164 ]
          Attachment DERBY-5184-tun.zip [ 12477165 ]
          Kim Haase made changes -
          Issue & fix info [Patch Available]
          Kim Haase made changes -
          Status Open [ 1 ] Resolved [ 5 ]
          Issue & fix info [Patch Available]
          Fix Version/s 10.8.1.3 [ 12316378 ]
          Fix Version/s 10.9.0.0 [ 12316344 ]
          Resolution Fixed [ 1 ]
          Kim Haase made changes -
          Status Resolved [ 5 ] Closed [ 6 ]
          Rick Hillegas made changes -
          Fix Version/s 10.8.1.4 [ 12316500 ]
          Fix Version/s 10.8.1.3 [ 12316378 ]
          Knut Anders Hatlen made changes -
          Fix Version/s 10.8.1.5 [ 12316676 ]
          Fix Version/s 10.8.1.4 [ 12316500 ]
          Myrna van Lunteren made changes -
          Fix Version/s 10.8.2.0 [ 12317955 ]
          Fix Version/s 10.8.1.6 [ 12316676 ]
          Myrna van Lunteren made changes -
          Fix Version/s 10.8.2.2 [ 12317968 ]
          Fix Version/s 10.8.2.0 [ 12317955 ]
          Gavin made changes -
          Workflow jira [ 12610024 ] Default workflow, editable Closed status [ 12801077 ]

            People

            • Assignee:
              Kim Haase
              Reporter:
              Kim Haase
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development