We need a section on camel-website root readme page, that talks about how you do links between pages on the website.
The xref: syntax is confusing and not intuitive how you link between: eips, components, user-manual, fag, pages between sub-projects (eg camel -> camel-k) and so forth.
For example in kamelet-eip.adoc as EIP doc, I could not link with
I tried 10 different things for the last two bullets, and looked other xref links, and nothing kinda worked.
So what you end up doing is NOT to have xref links at all.