[
https://issues.apache.org/jira/browse/JENA-482?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13744283#comment-13744283
]
Ian Dickinson commented on JENA-482:
------------------------------------
It's a great job, Samuel, thank you. I do think there's still a concern on
second level navigation. Consider the following pages from the old and new
design:
http://jena.apache.org/documentation/tdb/assembler.html
http://jena.staging.apache.org/documentation/tdb/assembler.html
On the old site, while I'm looking at a page on TDB assembler I can still see
(i) the range of other topics that I might want to dig into, in the case that
TDB isn't (the only) Jena documentation I'm interested in, and (ii) some -
though admittedly not all - of the other TDB topic pages. In the new design, I
lose that second level context. To see the other TDB pages I have to click
back, to see the other top-level documentation topics I have to go back twice.
I'd be the first to admit that the old left-menu isn't perfect, and does look
dated. It's imperfect because it's neither brief, nor complete. Andy and I
debated this a bit back when Jena first migrated to Apache, and the current
selection of topics in the nav menu is an uneasy compromise between compactness
and completeness. But I think that some level of persistent second-level
navigation does meet a need in the UX.
There are a couple of ways we could address this. One would be to add some
level of secondary navigation menu, as a second horizontal bar or a floating
page menu. Another would be to add a trail with links to the next topic,
previous topic and overview. Those serve different purposes, but I think either
would add some useful orientation. There may be other solutions as well.
> Website re-organisation and facelift
> ------------------------------------
>
> Key: JENA-482
> URL: https://issues.apache.org/jira/browse/JENA-482
> Project: Apache Jena
> Issue Type: Documentation
> Components: Web site
> Reporter: Samuel Croset
> Assignee: Rob Vesse
> Priority: Minor
> Labels: documentation
> Attachments: new_website.diff
>
>
> I've been experimenting a bit in the last couple of days over the Jena
> website and documentation. You can see a live demo version of the result
> here: http://loopasam.github.io/jena-doc/index.html
> My motivation was to try to make the overall browsing experience a bit
> clearer and nicer looking without disrupting too much what's already in place.
> I have refactored some of the skeleton and CSS using Twitter Bootstrap. I
> haven't changed any of the build mechanism (ASF-CMS), so pretty much all the
> documents and pages are working just as before out of the box.
> Before doing more work on this I wanted to know what the community thinks of
> it and whether it could be integrated with the current code.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira
