Fix haddocks generation in GHA

[carbolymer]

Changelog

- description: |
    Fix haddocks generation in GHA
# 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

This PR reuses https://github.com/input-output-hk/cardano-node/blob/master/scripts/haddocs.sh from cardano-node

Fixes #188

Checklist

• Commit sequence broadly makes sense and commits have useful messages
• The change log section in the PR description has been filled in
• New tests are added if needed and existing tests are updated. These may include:
  • golden tests
  • property tests
  • round trip tests
  • integration tests
    See Running tests for more details
• The version bounds in .cabal files are updated
• CI passes. See note on CI. The following CI checks are required:
  • Code is linted with hlint. See .github/workflows/check-hlint.yml to get the hlint version
  • Code is formatted with stylish-haskell. See .github/workflows/stylish-haskell.yml to get the stylish-haskell version
  • Code builds on Linux, MacOS and Windows for ghc-8.10.7 and ghc-9.2.7
• The changelog section in the PR is updated to describe the change
• Self-reviewed the diff

[smelc]

When running the script locally, it fails with:

Error: cabal: Failed to build documentation for set-algebra-1.1.0.1 (which is
required by lib:gen from cardano-api-8.20.0.0).

I suspect it's not an issue of this PR, but is there a way I could test the end of the script? (since it's the early cabal haddock call that fails 🙁).

[carbolymer]

@smelc you can try to follow the steps in github-page.yml to generate haddocks.

[newhoggy]

Could be worthwhile converting this into a re-usable Github Action