@mfussenegger I hope this will work for you :)

I had in mind that the annotations in the code keep using @class and so on, but that the generated documentation would look as if it it were inlined (maybe via an option).

But this should be fine as well.

but that the generated documentation would look as if it it were inlined (maybe via an option).

Yeah, that's the downside (loosing LLS support) of the current approach. But inlining class is also that'll be useful but is bigger to implement, I'll surely look into.