Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Possibly incorrect link to main page from "Templates generator"?

オープン
#9 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
35/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
停滞
領域
documentation

調査の方向性

docs/source/utilities/yaml_generator.rst から始めて :backends_content: 参照を確認し、その後 docs/source/index.rst での配置を docs/source/utilities/templates.rst と比較します。参照先がメインページではなく YAML テンプレートになっていることを確認します。完了の条件は、レンダリングされた Templates generator リンクから意図したテンプレートのドキュメントが開くことです。

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

説明

documentation question

The use of the reference :backends_content in this line: https://github.com/DiamondLightSource/httomo-backends/blob/a34bf5802fc541ef5a0c541377b000ce596882aa/docs/source/utilities/yaml_generator.rst?plain=1#L5

appears to be wanting to link to the YAML templates that have been generated.

However, while the text of the link is what is expected for a link to YAML templates:
templates-generator-link

it actually links to the main page, which doesn't seem like what would be intended?

The linking to the main page is likely due to the reference being put in index.rst: https://github.com/DiamondLightSource/httomo-backends/blob/a34bf5802fc541ef5a0c541377b000ce596882aa/docs/source/index.rst?plain=1#L3-L9

and should instead be moved to somewhere in the templates.rst file.

主要言語
Python
スター
0
フォーク
1
PR マージ指標
30日以内にマージされた PR はありません

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

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

DiamondLightSource/httomo-backends のほかの issue

DiamondLightSource/httomo-backends の issue をすべて見る

似ている issue

Python の issue をもっと見る

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

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