> but i wonder how to organize my dirs and files when i want to reference (include:link) code the antora way when it is not located within the antora related content tree, i.e. the actual source of a component

This is not currently possible in Antora (by default). Refer to the following open issue: https://gitlab.com/antora/antora/-/issues/195

There are two ways around it that I can suggest:

* Move those files you want to include into the Antora content hierarchy

* Use a custom site generator component to import additional files in the Antora content catalog after it retrieves the files from the git indexes / worktrees

If you have a situation where an include doesn't resolve when you're not using Antora, you can register an include processor that emulates the behavior of Antora's include processor.

Best Regards,

-Dan