apache / apache/pekko-site

Broken verification instructions

Open
#98 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
58
Forks
15
Avg merge
5h 7m
Merged PRs (30d)
5

Description

The verification instructions at
https://github.com/apache/incubator-pekko-site/blob/4f171bca3915c06ee5964e9edf35966e4dec323a/content/download.html#L286
and
https://github.com/apache/incubator-pekko-site/blob/4f171bca3915c06ee5964e9edf35966e4dec323a/content/download.html#L292

are unnecessarily complicated, and will not work in all situations.

Using 'find' may result in applying the command to additional unrelated downloads, depending on where the files are downloaded. It will only work correctly if the files are in a leaf directory with no other hashes or sigs. Find by default traverses all nested directories. Also Windows has a completely different 'find' command.

In addition, safe GPG verification requires both artifact and signature to be provided on the command line [1].

[1] https://www.apache.org/info/verification.html#CheckingSignatures

Contributor guide

No contributing guide indexed for this repository

Research direction

Open content/download.html around lines 286 and 292, then read the linked Apache verification guidance. Replace the unsafe, platform-specific verification instructions with steps that explicitly provide both artifact and signature files and avoid broad find traversal. Done means the published instructions are unambiguous and work without depending on a leaf directory or Windows find behavior.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.