`nim doc2` follows include files and is generally what should be used. I can't answer the other questions, I'm afraid.
- Tutorials and documentation for a nim project mratsim
- Re: Tutorials and documentation for a nim project mratsim
- Re: Tutorials and documentation for a nim project Araq