bazelbuild / bazelbuild/bazel

[bazel.build] Mutliple problems with /install/ubuntu

Open
#26,309 3 comments 0 reactions 0 assignees View on GitHub
help wanted P2 team-Documentation team-OSS type: documentation (cleanup)
Dominant language
Java
Stars
25.8k
Forks
4.6k
Avg merge
2d 18h
Merged PRs (30d)
75

Description

### Page link:

https://bazel.build/install/ubuntu

### Problem description (include actual vs expected text, if applicable):

Hi,

the installation instructions for Debian/Ubuntu contain multiple errors:

* The `apt-transtport-https` package is a dummy since Debian Stretch, as of which its functionality has been integrated into the main `apt` package, so its installation is useless
* The repository keyring should NOT be stored in `/usr/share/keyrings` unless there's also a package available for managing the keyring going forward. If such a package doesn't exist, the keyring should be stored in `/etc/apt/keyrings` instead. See [here](https://wiki.debian.org/DebianRepository/UseThirdParty) for the details, where it says:
> If future updates to the certificate will be managed by an apt/dpkg package as recommended below, then it SHOULD be downloaded into /usr/share/keyrings using the same filename that will be provided by the package. If it will be managed locally , it SHOULD be downloaded into /etc/apt/keyrings instead.

Please fix.

### Where do you see this issue? (include link to specific section of the page, if applicable)

https://bazel.build/install/ubuntu#install-on-ubuntu

### Any other information you'd like to share?

_No response_

Contributor guide

Open the contributing guide

Research direction

Open the linked bazel.build Ubuntu installation page and review the Debian/Ubuntu package and repository-key instructions. Update the guidance to remove the obsolete apt-transport-https package and use the locally managed keyring location described in the issue; done when the installation steps follow current Debian guidance.

Written by the indexing model from the issue text.

Assessment

Tech stack
debian, ubuntu
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.