Use definition lists for glossary?
メンテナーはふだん 17 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 28/100
- issue の種類
- ドキュメント
- 明瞭さ
- 説明が足りない
- 活発さ
- 停滞
- 技術スタック
- html, markdown
調査の方向性
用語集のソースを特定し、定義リスト構文がサポートされているか判断するために、リポジトリの Markdown プロセッサまたは設定を調査します。現在のマークアップを提案されている
- /
- /
- 形式と比較し、生成されるリンクとアンカーを検証します。完了とは、文書化された判断があり、採用する場合は用語集が一貫した形で変換されていることを意味します。
索引モデルが issue の本文から書いたものです。
説明
Perhaps this is somewhat pedantic, but I wonder whether we should be move from an unordered list of terms to a definition list for the glossary?
This would be more semantically correct and would allow us to avoid manual hard breaks in our current source text, e.g.:
- allocate:\
Dynamic memory allocation on [the heap](memory-management/review.md).
- argument:\
Information that is passed into a function or method.
- associated type:\
A type associated with a specific trait. Useful for defining the relationship
between types.
Unfortunately, it looks as though current markdown processor does not support the extended syntax for dl, dt and dd tags.
That would mean that we would be required to hand-write HTML:
<dl>
<dt>allocate</dt>
<dd>Dynamic memory allocation on <a href="memory-management/review.html">the heap</a>.</dd>
<dt>argument</dt>
<dd>Information that is passed into a function or method.</dd>
<dt>associated type</dt>
<dd>A type associated with a specific trait. Useful for defining the relationship between types.</dd>
…which would unlock the ability to refer to the glossary from other parts of the course.
<dt id="allocate">allocate</dt>
<dd>Dynamic memory allocation on <a href="memory-management/review.html">the heap</a>.</dd>
- 主要言語
- Rust
- スター
- 33.5k
- フォーク
- 2.1k
- 平均マージ
- 16日 20時間
- マージ済み PR（30日）
- 1
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
google/comprehensive-rust のほかの issue
-
Graph can be created in safe Rust very well対応中かも @sanjitpawar2007-hue が 19 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
google/comprehensive-rust#2955 ·
メンテナーはふだん 17 日以内に返信
-
"Calling unsafe functions" example is confusing対応中かも @haranishi が 25 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
google/comprehensive-rust#2733 · リアクション 1 件 ·
メンテナーはふだん 17 日以内に返信
-
Binary tree exercise is a binary *search* tree対応中かも @haranishi が 25 日前に担当しました。 オープン
難易度 1/5 1時間未満 初心者へのやさしさ 72/100
google/comprehensive-rust#2732 ·
メンテナーはふだん 17 日以内に返信
-
Minor suggested updates to the Collatz Sequence exercise in section 6.8 and its solution in section 6.8.1対応中かも このイシューにリンクされたプルリクエストがオープン中、またはマージ済みです。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
google/comprehensive-rust#2636 · コメント 3 件 ·
メンテナーはふだん 17 日以内に返信
-
Russian translation: could you add a link?対応中かも このイシューにリンクされたプルリクエストがオープン中、またはマージ済みです。 オープン
難易度 1/5 1時間未満 初心者へのやさしさ 50/100
google/comprehensive-rust#3315 · コメント 1 件 ·
メンテナーはふだん 17 日以内に返信
google/comprehensive-rust の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 86/100
メンテナーはふだん 1 日以内に返信
-
`nsh-core` fails to compile when taffy's default `calc` feature is enabled elsewhere in the graphオープン
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
longbridge/nsh#966 ·
メンテナーはふだん 1 日以内に返信
-
Windows docs: pin a tested ConPTY version for Kitty graphics; 1.25.260930003 corrupts large uploadsオープン
難易度 1/5 1〜3時間 初心者へのやさしさ 88/100
raphamorim/rio#2021 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
hydro-project/infinity#187 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 77/100
near/near-sdk-rs#1676 ·
メンテナーはふだん 2 日以内に返信