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

Glossary

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

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

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
30/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
停滞
領域
documentation

調査の方向性

issue #104 の用語集とその定義を確認し、記載されている用語やその他のコード概念について明確化が必要か検討してください。Issue 内で不明確な用語について議論し、合意した定義が用語集に反映されれば完了です。

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

説明

  • Subject - a single value (string or binary) which best records a snapshotted entity
  • Facet - a single named value (string or binary) which records a single aspect or point of view of a snapshotted entity
  • Snapshot - a combination of a subject and zero or more facets which captures all relevant data of an entity whose behavior we wish to record and specify
  • Camera - a function that transforms a specific type of entity into a snapshot
  • Lens - a function which transforms one snapshot into a new snapshot, usually by adding new facets that emphasize a certain point of view of the subject, but possibly also by cleaning the existing subject and facets
  • Equality assertion - a success condition which requires a value under to test to exactly match an expected value
  • Inline snapshot - an equality assertion where the expected value can be written into the sourcecode by automated tooling
  • Inline literal snapshot - an inline snapshot where the expected value must always be a source code literal, never a compound expression
    • expect(2 + 2).toMatchInlineSnapshot(4) <-- inline literal snapshot
    • expect(2 + 2).toMatchInlineSnapshot(2 * 2) <-- inline literal snapshot, because it's not literal, when tooling modifies the value inside (), it can't do a self-error-check to make sure it has correctly parsed the same value which got passed at runtime
    • Conversationally people will say "inline snapshot", "literal snapshot", "inline literal snapshot", etc. They mostly mean the same thing, but in selfie we will try to always say "inline literal".

If you think any of these terms are unclear, feel free to discuss below. If there are any other concepts in the code which should be defined explicitly, feel free to discuss below. The final result of all discussions is incorporated into the list above via editing, after which the discussions may be deleted. This glossary is based on an idea from Rich Hickey's Design in Practice talk.

主要言語
Kotlin
スター
101
フォーク
18
平均マージ
6日 11時間
マージ済み PR(30日)
5

環境構築

はじめの一歩

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

diffplug/selfie のほかの issue

diffplug/selfie の issue をすべて見る

似ている issue

Kotlin の issue をもっと見る

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

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