Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Glossary

Đang mở
  • Có gì không ổn?
#104 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
30/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Đình trệ
Lĩnh vực
documentation

Hướng nghiên cứu

Xem lại bảng thuật ngữ và các định nghĩa của bảng trong issue #104, sau đó cân nhắc xem các thuật ngữ được liệt kê hoặc bất kỳ khái niệm mã nào khác có cần được làm rõ hay không. Thảo luận về thuật ngữ chưa rõ ràng trong issue; được xem là hoàn tất khi các định nghĩa đã thống nhất được đưa vào bảng thuật ngữ.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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

Ngôn ngữ chính
Kotlin
Star
101
Fork
18
Merge trung bình
16 giờ 35 phút
Pull request đã merge (30 ngày)
3

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của diffplug/selfie

Tất cả issue của diffplug/selfie

Issue tương tự

Thêm issue về Kotlin

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.