haskell / haskell/cabal

Section on using secure repositories is incomplete

Open
#9,842 1 comment 0 reactions 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?**

https://cabal.readthedocs.io/en/stable/config.html#using-secure-repositories

At the end of this section, speaking about how to find trusted root keys, the document states "How that is done is... outside the scope of cabal proper." This sentence speaks to a certain familiarity with how these things are supposed to work, and subtly hints that there's probably a more general problem here that could be solved in "the usual ways". But... I certainly don't know how to go about it. Do you? Does anybody? Some pointers would be helpful.

Contributor guide

Open the contributing guide

Research direction

Start with the “Using secure repositories” section at config.html#using-secure-repositories, especially the sentence about finding trusted root keys. Review the surrounding Cabal documentation and the secure-repository implementation or references to determine what practical pointers can be documented. Done means the section explains where users can find or configure trusted root keys without relying on unexplained familiarity.

Written by the indexing model from the issue text.

Assessment

Domain
documentation, security
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.