It would be good for have API docs generated from comments in the C++ source.

Even though the internal Nix library APIs are unstable and therefore not intended for large scale outside consumption, contributers to Nix itself would still benefit.

Also, in conjunction with stable bindings to other languages, we've discussed stabilizing parts of the C++ interfaces. This would naturally be good for that.