Add Doxygen

[evgenykor]

Generate up to date documentation for source code with Doxygen

includes make integration with

make docs

Final output has html with pretty call graphs structures like e.g.:

[marcos-diaz]

I got it running (serving the HTML with npm serve 😅)

I'm not so familiar with big C/C++ project standards, but here some of my immediate (and naive) questions:

• Under which section are the nice diagrams?
• Does this really add much value for the developer compared to navigating the symbols with VSCode or IntelliJ?
• Should be this intended as a purely optional thing? or be hosted somewhere like (docs.inputlabs.io)?

[evgenykor]

• Under which section are the nice diagrams?

Go to "Files" section then click on some of the files, there you could see functions associated to this file with call diagrams Diagram itself is also clickable - you may transfer to other function calls across all of that.

• Does this really add much value for the developer compared to navigating the symbols with VSCode or IntelliJ?

It is documentation no navigating thing (i.e. it is not LSP server e.t.c.). One cool feature of having something like this - you always have up-to-date documentation because it is literally compiled from your source code at any given moment.

• Should be this intended as a purely optional thing? or be hosted somewhere like (docs.inputlabs.io)?

Sure thing. It is totally up to you. I just wanted to share some of "best practices".

[evgenykor]

• I got it running (serving the HTML with npm serve 😅)

I usually just do python -m http.server 8888 with some port forwarding to remote server like ssh -L 8888:localhost:8888 ekornev@my_remote_server