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

docs: one authoritative spec (SPEC / LANGUAGE_CONTRACT / GRAMMAR / SYNTAX overlap)

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

Maintainer thường phản hồi trong vòng 1 ngày

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

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
45/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Lĩnh vực
documentation

Hướng nghiên cứu

The issue mentions four documents in the docs/ directory: SPEC.md, LANGUAGE_CONTRACT.md, GRAMMAR.md, and SYNTAX.md. Start by reading these files to understand their current content and overlaps. Look for duplicated normative statements. The goal is to consolidate them into one authoritative spec, ensuring all executable examples still run and updating references in llms.txt and the mentioned skills.

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

Mô tả

area:docs kind:decision

Problem. Four documents cover overlapping ground on what the language IS: docs/SPEC.md (2,272 lines), docs/LANGUAGE_CONTRACT.md, docs/GRAMMAR.md and docs/SYNTAX.md. Overlap means copies, and copies disagree. The 2026-09-22 prompt audit found write-eigenscript teaching three semantics the language had since changed (loop-body scope, observer keying, constant convergence), because it summarised a copy rather than the contract.

What mature languages do. There is exactly one authoritative specification, separate from the tutorial: the Go spec (a single page), Python's Language Reference, the Rust Reference.

Bar.

  1. One document is THE spec. It carries the grammar (or includes GRAMMAR by reference) and the contract rules. Every normative statement lives there exactly once.
  2. The other three are either folded in, or turned into explanation that links to spec sections instead of restating them. Checked: no normative rule text appears in two documents (a duplication grep, or the docs-claims NAMES class).
  3. Every executable example in the merged spec still runs.
  4. llms.txt and the write-eigenscript / eigenscript-lang-review skills point at the one spec.

Ranked #4 of the docs follow-ups (2026-09-22 comparison with other languages).

Ngôn ngữ chính
C
Star
3
Fork
7
Merge trung bình
3 giờ 56 phút
Pull request đã merge (30 ngày)
102

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

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

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 InauguralSystems/EigenScript

Tất cả issue của InauguralSystems/EigenScript

Issue tương tự

Thêm issue về C

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.