Skip to content

Fix dead docs link in v1- command help text - #12549

Merged
mergify[bot] merged 2 commits into
haskell:masterfrom
swinilohani616-dot:fix/v1-help-dead-link
Nov 12, 2026
Merged

mergify[bot] merged 2 commits into
haskell:masterfrom
swinilohani616-dot:fix/v1-help-dead-link

Conversation

@swinilohani616-dot

@swinilohani616-dot swinilohani616-dot commented Nov 7, 2026 •

Copy link
Copy Markdown
Contributor

Fixes #12550

Running any cabal v1-* command prints a note saying v1 is legacy, and it ends with a link to
the nix-style builds docs. That link (nix-local-build-overview.html) now returns a 404 on Read the Docs.
I noticed it and pointed the note at nix-local-build.html, the current page for that topic.

I also updated the checked-in help text in doc/cmd-v1-help/ so it matches and the cmd-help CI check stays green.
The two old HCAR reports in doc/hcar/ still use the old URL. I left them alone since they're historical.

The legacy note shown by `cabal v1-*` commands linked to
nix-local-build-overview.html, which now 404s on the user guide.
Point it at nix-local-build.html instead, and update the generated
help text in doc/cmd-v1-help to match.

@ffaf1 ffaf1 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@zlonast zlonast added the merge me Tell Mergify Bot to merge label Nov 8, 2026
@mergify mergify Bot added the ready and waiting Mergify is waiting out the cooldown period label Nov 8, 2026

@ulysses4ever ulysses4ever left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@mergify mergify Bot added merge delay passed Applied (usually by Mergify) when PR approved and received no updates for 2 days queued labels Nov 11, 2026
@mergify

mergify Bot commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

❌ Left the queue · Validate macos-15 ghc-9.10.3 fails with this pull request

1 h 29 min in the queue, 1 h 17 min of it CI.

So far

The failure is in this pull request. It failed tested alone on top of master.

Reason

The merge conditions cannot be satisfied due to failing checks

  • Validate post job

Failing checks:

To get back in the queue

  • Push a fix: the pull request is queued again once its queue conditions match.
  • If the failure is a flake, comment @mergifyio queue to queue it again as it is.

Merge conditions not met when it left the queue

  • any of · required by GitHub branch protection:
    • check-neutral = Validate post job
    • check-skipped = Validate post job
    • check-success = Validate post job
11 merge conditions met
  • #review-threads-unresolved = 0 · required by GitHub branch protection
  • github-review-approved · required by GitHub branch protection
  • any of · required by GitHub branch protection:
    • check-success = Doctest Cabal
    • check-neutral = Doctest Cabal
    • check-skipped = Doctest Cabal
  • any of · required by GitHub branch protection:
    • check-success = Meta checks
    • check-neutral = Meta checks
    • check-skipped = Meta checks
  • any of · required by GitHub branch protection:
    • check-success = docs/readthedocs.org:cabal
    • check-neutral = docs/readthedocs.org:cabal
    • check-skipped = docs/readthedocs.org:cabal
  • any of · required by GitHub branch protection:
    • check-success = fourmolu
    • check-neutral = fourmolu
    • check-skipped = fourmolu
  • any of · required by GitHub branch protection:
    • check-success = hlint
    • check-neutral = hlint
    • check-skipped = hlint
  • any of · required by GitHub branch protection:
    • check-success = Bootstrap post job
    • check-neutral = Bootstrap post job
    • check-skipped = Bootstrap post job
  • any of · required by GitHub branch protection:
    • check-success = whitespace
    • check-neutral = whitespace
    • check-skipped = whitespace
  • any of · required by GitHub branch protection:
    • check-success = Check sdist post job
    • check-neutral = Check sdist post job
    • check-skipped = Check sdist post job
  • any of · required by GitHub branch protection:
    • check-success = Changelogs
    • check-neutral = Changelogs
    • check-skipped = Changelogs

Times in UTC · dashboard · how the merge queue works

@mergify mergify Bot mentioned this pull request Nov 11, 2026
42 of 87 tasks
@mergify mergify Bot added dequeued and removed queued labels Nov 11, 2026
@zlonast

zlonast commented Nov 12, 2026

Copy link
Copy Markdown
Collaborator

@Mergifyio queue

@mergify

mergify Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

✅ Merged into master as 2cc64af at 06:12 UTC

Merged together with #12497. 2 h 15 min in the queue, 2 h 4 min of it CI.

So far

12 merge conditions met
  • #review-threads-unresolved = 0 · required by GitHub branch protection
  • github-review-approved · required by GitHub branch protection
  • any of · required by GitHub branch protection:
    • check-success = Doctest Cabal
    • check-neutral = Doctest Cabal
    • check-skipped = Doctest Cabal
  • any of · required by GitHub branch protection:
    • check-success = Meta checks
    • check-neutral = Meta checks
    • check-skipped = Meta checks
  • any of · required by GitHub branch protection:
    • check-success = docs/readthedocs.org:cabal
    • check-neutral = docs/readthedocs.org:cabal
    • check-skipped = docs/readthedocs.org:cabal
  • any of · required by GitHub branch protection:
    • check-success = Validate post job
    • check-neutral = Validate post job
    • check-skipped = Validate post job
  • any of · required by GitHub branch protection:
    • check-success = fourmolu
    • check-neutral = fourmolu
    • check-skipped = fourmolu
  • any of · required by GitHub branch protection:
    • check-success = hlint
    • check-neutral = hlint
    • check-skipped = hlint
  • any of · required by GitHub branch protection:
    • check-success = Bootstrap post job
    • check-neutral = Bootstrap post job
    • check-skipped = Bootstrap post job
  • any of · required by GitHub branch protection:
    • check-success = whitespace
    • check-neutral = whitespace
    • check-skipped = whitespace
  • any of · required by GitHub branch protection:
    • check-success = Check sdist post job
    • check-neutral = Check sdist post job
    • check-skipped = Check sdist post job
  • any of · required by GitHub branch protection:
    • check-success = Changelogs
    • check-neutral = Changelogs
    • check-skipped = Changelogs

Times in UTC · dashboard · how the merge queue works

@mergify mergify Bot added queued and removed dequeued labels Nov 12, 2026
@mergify
mergify Bot merged commit 2cc64af into haskell:master Nov 12, 2026
81 checks passed
@mergify mergify Bot removed the queued label Nov 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

merge delay passed Applied (usually by Mergify) when PR approved and received no updates for 2 days merge me Tell Mergify Bot to merge ready and waiting Mergify is waiting out the cooldown period

Projects

None yet

Development

Successfully merging this pull request may close these issues.

v1- commands link to a docs page that no longer exists

4 participants