Fix haddocks generation - now using nix

[carbolymer]

Changelog

- description: |
    Fix haddocks generation - now using nix
# uncomment types applicable to the change:
  type:
  # - feature        # introduces a new feature
  # - breaking       # the API has changed in a breaking way
  # - compatible     # the API has changed but is non-breaking
  # - optimisation   # measurable performance improvements
  # - improvement    # QoL changes e.g. refactoring
  # - bugfix         # fixes a defect
  # - test           # fixes/modifies tests
   - maintenance    # not directly related to the code
  # - release        # related to a new release preparation
   - documentation  # change in code docs, haddocks...

Context

Fixes the same issue which happened in cardano-api repo:

• [BUG] - haddocks for public library modules are missing  cardano-api#437

This PR copies changes from cardano-api from:

• Fix haddocks references to libraries cardano-api#363
• Use latest cabal master for haddocks generation. Fix broken haddocks. cardano-api#577

Sample workflow run with generated haddocks (attached as an artifact): https://github.com/IntersectMBO/cardano-cli/actions/runs/9796004207

Checklist

• Commit sequence broadly makes sense and commits have useful messages
• New tests are added if needed and existing tests are updated. See Running tests for more details
• Self-reviewed the diff

[carbolymer]

FIXME:

• generated haddocks contain only docs for the tests - docs for library and exe are missing

[smelc]

@andreabedini> would you have a clue why this PR only produces haddocks for tests (see @carbolymer's comment above: #445 (comment))?

[andreabedini]

@andreabedini> would you have a clue why this PR only produces haddocks for tests (see @carbolymer's comment above: #445 (comment))?

It looks like they are created but somehow only the tests (the ones created last) make it into the index.

[carbolymer]

• TODO: test against haddock-project support public sublibraries haskell/cabal#9821

[Jimbo4350]

LGTM however I'm not seeing the haddocks action in the summary.

[coot]

😄 🎉