Re-order sub projects in version picker popup menu in the website

[davsclaus]

In the bottom left corner you can choose versions of docs. However the order should be improved

User Manual
Components
Camel Spring Boot
Camel Quarkus
Camel K
Camel Kafka Connector
Camel Karaf
Kamelet Catalog

[davsclaus]

[djencks]

I don't see the principles behind your suggested ordering. Here are my thoughts:

user manual -explains what camel is all about, needs to be first
camel - camel core, needs to be next, everything else depends on it.
...
kamelets - IIUC this is a generic way of representing partial configurations of one or more camel components, usable in several environments. This is qualitatively different from everything else, and it makes sense to me to put it at the end.

---

Everything else.... IIUC these are ways of running camel components in different environments, with various degrees of generated and hand-written wrapper code. I can think of two reasonable orderings:

• alphabetical, yielding what we have now except with kamelets at the end.
• by increasing amount of generated and hand-written wrapper code. I'm not sure but I think this would yield something like

Camel-Karaf
Camel-Spring-Boot
Camel-K
Camel-Kafka-Connector
Camel-Quarkus

How did you select the ordering of these items?

[davsclaus]

Where is the source code for the version picker?

[djencks]

The version picker itself is antora-ui-camel/src/partials/nav-explore.hbs

The code for ordering the components is in antora-ui-camel and is kind of spread out between
src/partials/nav-explore.hbs:

    {{#each (exclude (order_components site.components) 'camel-quarkus-examples')}}

and
src/helpers/order_components.js

I wrote an article on how to do this... https://blog.yuzutech.fr/blog/sort-antora-components/index.html, possibly using a more configurable approach such as I suggest might be useful.

Before making any changes I hope you'll explain your reasoning.