Hi Paolo,
I find this sort of pages with too long list to chose from a
little bit confusing (i.e. too many choices in one place):
http://www.openjena.org/documentation.html
This is basically the issue in a nutshell. We *already have* a lot of content. On the whole, it's good useful information, but it's often hard to navigate and locate the what people need. We *should not* be considering getting rid of any of it, or rewriting from scratch. The issue then, is how to organize what we have. Getting the navigation right is a central problem in the usability of web sites [1].

You're right to say that the current jump-list page of links is hard to use. I agree. But I can't see how you can you can claim that we have neither a flat structure nor a hierarchy.

You propose a simple structure based on the internal organization of the software: ARQ, inference, ontology etc. This does not work for people who don't already know the internal structure of the code, which is, I claim, most people. We need to try to see this from the point of view of people outside the project. Users rarely, or never, arrive with a goal to the effect of "I need to read tutorial on ARQ".

Jena is a complex collection of functionality, and our users have very diverse needs. Unless we recognise that, we're doing them a disservice and making life harder for ourselves in the long run.

Ian

[1] http://www.useit.com/alertbox/ia-mistakes.html

--
____________________________________________________________
Ian Dickinson                   Epimorphics Ltd, Bristol, UK
mailto:[email protected]        http://www.epimorphics.com
cell: +44-7786-850536              landline: +44-1275-399069
------------------------------------------------------------
Epimorphics Ltd.  is a limited company registered in England
(no. 7016688). Registered address: Court Lodge, 105 High St,
              Portishead, Bristol BS20 6PT, UK

Reply via email to