[
https://issues.apache.org/jira/browse/CAMEL-14581?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17057798#comment-17057798
]
Zoran Regvart commented on CAMEL-14581:
---------------------------------------
[~aashnajena] I think the key piece of information you might be missing is that
the website has two sets of templates we use to render HTML files and we need
to keep those two in sync. First part is the static content from Hugo
(frontpage, blog, releases/downloads, landing pages for projects and such), and
the documentation bits are built by Antora. One easy way to distinguish what
belongs to which part is to look at the left hand side navigation if it appears
then the content comes from Antora build.
The two templates are within Hugo {{layouts}} and in
{{antora-ui-camel/src/layouts}} and {{antora-ui-camel/src/partials}}. The menu
system is driven from the {{config.toml}} in the root of the repository which
directly drives the Hugo build. For Antora build we include the data in the
{{config.toml}} via {{menu.js}} that provides the {{withMenuData}} helper to
Handlebars in Antora layout templates.
I've created a sub task of this issue for colour contrast, feel free to discuss
your ideas there (CAMEL-14700) or mention the issue on the pull request if you
already have some improvements to contribute.
[~jyotiattri] please feel free to suggest improvements you think are needed,
you can propose changes on the subtask here: CAMEL-14701
> Website usability improvements
> ------------------------------
>
> Key: CAMEL-14581
> URL: https://issues.apache.org/jira/browse/CAMEL-14581
> Project: Camel
> Issue Type: Improvement
> Components: website
> Reporter: Zoran Regvart
> Priority: Major
> Labels: help-wanted
> Attachments: appache&opensource.jpg, camel-projects-2.png,
> camel-projects.png, camel_mobile_menu.jpeg
>
>
> The current Apache Camel website can use some help with the usability. I've
> identified the following areas that could improve:
> * simpler top level navigation: currently we have Blog, Projects,
> Documentation, Community, Download, About; some of these also have sub-menu
> items. I think we could benefit from a simpler organization and perhaps get
> rid of sub-menus and serve pages with content regarding each section (e.g.
> documentation page could have pointers to different kinds of documentation we
> currently have on the sub-menu)
> * accessibility (readability/contrast/...): we should run audits and make
> sure that the website is accessible
> * rework menus on low resolution: make sure that the menus are large enough
> and readable on lower resolution
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
