Feedback for "Install"

オープン 初心者向け
#372 コメント 2 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
1/5
見積もり時間
1〜3時間
初心者へのやさしさ
78/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
静か
技術スタック
fedora
領域
documentation

調査の方向性

Terra のドキュメントの「Bazzite and Aurora」セクションを開き、issue に記載されている「Fedora Atomic and Derivatives」の手順と比較します。Terra が存在しない場合の検証手順と repository-file および terra-release の手順への参照を追加し、レンダリングされたドキュメントが提案された復旧パスを正確に反映していることを確認します。

索引モデルが issue の本文から書いたものです。

説明

Hi! Quick docs improvement request based on a fresh Bazzite install (GNOME/Wayland, Fedora 43 base).

The Terra docs at https://developer.fyralabs.com/terra/installing#bazzite-and-aurora state:

Bazzite and Aurora come with Terra out of the box, simply rpm-ostree away!

but on my system the Terra repo was not enabled initially. rpm-ostree install espanso-wayland failed with “Packages not found”, and the enabled rpm-md repos listed were only fedora, updates, etc.

Running the “Fedora Atomic and Derivatives” steps from the Terra docs fixed it immediately:

curl -fsSL https://github.com/terrapkg/subatomic-repos/raw/main/terra.repo | pkexec tee /etc/yum.repos.d/terra.repo
sudo rpm-ostree install terra-release

After that, I could find and install the package I was looking for.

Suggestion:

In the “Bazzite and Aurora” section, add a one-line verification step (e.g., confirm terra appears in rpm-ostree enabled repos / confirm rpm-ostree search terra-release returns results), and if not present, point users to the Atomic repo-file + terra-release instructions.

This would prevent a lot of confusion for new users unfamiliar with the way this works, because the current text reads as unconditional!

Thanks!

主要言語
MDX
スター
14
フォーク
19
平均マージ
7日 12時間
マージ済み PR（30日）
9

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

FyraLabs/devdocs のほかの issue

FyraLabs/devdocs の issue をすべて見る

似ている issue

Documentation の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。