haskell / haskell/cabal

Show an example of solver rejection in docs

Open
#9,826 0 comments 1 reaction 0 assignees View on GitHub
cabal-install: solver documentation
Dominant language
Haskell
Stars
1.7k
Forks
750
Avg merge
4d 3h
Merged PRs (30d)
28

Description

> The documentation doesn't have any example of solver rejection?

Searching for "rejecting" in `*.rst` gets no hits.

_Originally posted by @philderbeast in https://github.com/haskell/cabal/issues/9824#issuecomment-2010092134_ in response to a question posed by @Kleidukos.

I remember when first trying out cabal, seeing the solver rejection message and not being able to come up with a solvable set of versions. It would be nice to have some walk-throughs on how to deal with these with examples.

Contributor guide

Open the contributing guide

Research direction

The issue points to documentation in *.rst; start by searching existing solver and dependency-resolution sections, including the absence of hits for "rejecting." Add a worked example or walkthrough for solver rejection, and verify that the documentation clearly explains how to handle the scenario.

Written by the indexing model from the issue text.

Assessment

Tech stack
haskell
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.