jetty / jetty.website

Antora-based jetty.org website.
https://jetty.org
Eclipse Public License 2.0
1 stars 4 forks source link

Consistency of left Menu vs right Contents #30

Closed gregw closed 6 months ago

gregw commented 6 months ago

The website pages have either: a menu of the left board; a contents in the top right; or both. Navigating the site can be confusing as the navigation mechanism pops from right to left and back again.

This could be made less confusing if the top level pages were more consistent in having both.

Specifically the home page https://jetty.github.io/jetty.website/ should to have a left Menu with the primary top level links to

It might also help if all pages displayed their Contents, even if mostly empty.

jmcc0nn3ll commented 6 months ago

I see what you are saying...the layout of these toc pages are currently treated differently if they are a 'website page' vs a 'documentation page'.

I'll take a look.

gregw commented 6 months ago

Can the right hand side "Contents" menu be renamed to "Page Contents", so it is clear that it is not the contents of the documentation, but just the page you are looking at. Then always have a left side navigation menu and it will be very clear.

jmcc0nn3ll commented 6 months ago

I think this is addressed now that the upper right menu is clearer and we have the Links dropdown. We can add to that as needed either directly to through another issue.