As the overall structore of the proposed site seems to be ok with
everybody, I'll try to get the stuff in SVN and work in your suggestions.
That will take some time, though I hope I will have finished it by today
evening (CET).
Thanks a lot for everyone's feedback.
Thomas
On Fri, 13 Jan 2006, Thomas Fischer wrote:
Hi,
In the last months, I grew more and more uncomfortable with the current
organisation of the Torque homepage, http://db.apache.org/torque.
The things I like least about it are
- when you change to a component of Torque (e.g. the runtime), the menu on
the left hand side "jumps" and you cannot get back via the menu to the
overview (you have to discover the links in the header)
- There is a lot of information scattered in the homepage, but it is very
difficult to locate the information.
So I went for it and tried to design a new page organisation, where the
issues above are resolved. The suggestion can be found at
http://people.apache.org/~tfischer/torque-docs/
Please have a look and write back whether you like the reorganisation or not.
I have rewritten and reviewed a lot of information in the runtime (that was
where the chaos was largest because that was once our top-evel page), but of
course also the new site is not perfect (though in my opinion it is loads
better than our present site). I am grateful for any hint what is missing or
wrong (e.g. I did not yet incorporate Greg's suggestion for an ant user
guide), but please also judge the general concept.
Implementation Details:
The method to avoid the jumping menu is to create a "skeleton menu" for the
site which is incorporated in every component (basically this is the part of
the menu where all items are closed) The disadvantage of this is that it is
very difficult to change that skeleton after publishing the site, so I tried
hard to create a very general skeleton.
I had to create two new subcomponents of Torque for this. One is the tutorial
(which in my opinion should live in its own component, anyway), the other is
docs-all-components where versioned docs which are not attributable to a
single Torque component (e.g. the database howtos) are located.
This is just a suggestion. I did not check in any of this to svn.
I look forward to hear your opinion
Thomas
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
