Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Glossary

Aperta
  • Qualcosa non va?
#104 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
30/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Ambito
documentation

Direzione di ricerca

Esamina il glossario e le relative definizioni nell’issue #104, quindi valuta se i termini elencati o altri concetti di codice necessitino di chiarimenti. Discuti la terminologia poco chiara nell’issue; il lavoro è completato quando le definizioni concordate sono state incorporate nel glossario.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

  • 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.

Lingua principale
Kotlin
Stelle
101
Fork
18
Merge medio
6g 11h
PR unite (30g)
5

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di diffplug/selfie

Tutte le issue di diffplug/selfie

Issue simili

Altre issue su Kotlin

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.