#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
     

Log in to post a comment.

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.





No, thanks