Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

#202 Please provide A) resizability and B) a no-frames user guide

websites
closed-fixed
nobody
websites (1)
1
2011-06-18
2008-08-26
Jason Spiro
No

== Problem ==

HSQLDB has a good website except for one problem. Due to your use of frames, it is difficult for users with small screens or low vision to read the user guide at www.hsqldb.org.[1] Frames have other problems too.[2]

== Solution ==

Step A) Kindly remove the word "noresize" from lines 7 and 9 of hsqlDocsFrame.html

Step B) When users click the "Docs" link at www.hsqldb.org, please do not send them into a frameset. Instead, send them to http://hsqldb.org/web/hsqlDocIndex.html. If you like, you can provide a "Show frames" link for users who want frames. The GCC project does not use frames for their documentation; it looks blander but is

== Footnotes ==

^ [1]. For example, on a Windows PC running at 1024x768 with the PPI bumped to 175% of normal, the top frame takes up about 40% of the screen, and the left frame takes up about 20%, leaving just 40% to show actual docs. Only ~10 full-width lines (13 rows, but wrapped) of actual docs are visible at a time.

^ [2]. See the six problems listed at http://wikipedia.org/wiki/Framing_\(World_Wide_Web)#Criticism

Discussion

  • Fred Toussi
    Fred Toussi
    2008-09-14

    Re A, we will do it.

    You can of course display what you describe by right clicking one of the links in the frameset and clicking "open in new window". The navigation links on the Guide pages can then be used.

    Another option currently at your disposal is going to the long version of the Guide directly

    http://hsqldb.org/doc/guide/guide.html

    We should provide a link to this

    Re the frameset, it includes more than the contents of the docs. It is almost impossible to provide unified indexes and cross links between different doc types (guide, javadoc, other docs), which are generated by running software. We will see if we can remove it.

     
  • Fred Toussi
    Fred Toussi
    2010-03-15

    • status: open --> closed-fixed
     
  • Fred Toussi
    Fred Toussi
    2010-03-15

    Have removed the frameset.

     
  • Fred Toussi
    Fred Toussi
    2010-05-12

    In fact, the bottom part of the frameset has been removed, but not the top.

     
  • Fred Toussi
    Fred Toussi
    2011-06-18

    • priority: 5 --> 1