How to generate documentation from arbitrary nix code?

My conclusions after further research:

  • Screw the disagreements about syntax (what the heck ?!?)
  • nix-doc is the way to go, short of 1652, even if nixpkgs has other path dependencies in its history
  • The mob programming momentum unfortunately didn’t seem to materialize

Remaining questions:

  • How to marry docs / examples and testing potentially via nixt
  • Similar to how styx did it