haskell / haskell/cabal

`cabal-version` semantics

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

Description

**What is wrong with the docs?**
I don't see a place where the semantics of `cabal-version` is documented. It could go to `CONTRIBUTING.md` (as a start?) because Cabal devs contribute features that prompt version bumps. Another place is the log for the version updates in the manual:

- https://cabal.readthedocs.io/en/3.10/file-format-changelog.html

**Additional context**
We have been getting requests to clarify the policy around `cabal-version` more often lately. E.g.

- https://github.com/haskell/cabal/pull/9535#issuecomment-1866354715

One place that looks relevant is https://github.com/haskell/cabal/wiki/Package-Description-Semantics but it looks completely in the woods and ancient.

A recent and very relevant discussion:

- https://github.com/haskell/cabal/issues/9331

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.