I'm working on the documentation for a new open source system for interactive fiction. It consists of a DSL and an API in Javascript and C#. I have some thoughts about what documentation I've liked, both practically and aesthetically. But it is clear there isn't yet a consensus and standard. There are a lot that model the Javadoc approach, some that use the Docco literate approach. And then lots of the tools I rely on (Node, jQuery, Mozilla's MDN, etc) use ad-hoc approaches.

So is there an approach that works well for you? Are there good approaches for multi-language systems? Why do you think there isn't a consensus?