Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
TLDR
Specification cleanup and consolidation. Removed redundant sections, improved formatting, and streamlined documentation without changing any language functionality.
What Was Added?
Nothing. This is purely a documentation cleanup.
What Was Changed / Deleted?
0001-Introduction.md: Condensed core principles from bullet list to concise feature overview. Removed verbose explanations.
0002-LexicalStructure.md: Simplified arithmetic operator documentation, removed redundant examples and explanations while keeping all functional details.
0003-Syntax.md: Cleaned up block expression documentation, removed excessive best practices section. Simplified field access rules while maintaining all restrictions.
0004-TypeSystem.md: Major cleanup removing excessive emphasis markers and redundant warnings. Streamlined record type structural equivalence section, removed verbose performance characteristics, consolidated collection type documentation.
0005-FunctionCalls.md: Reformatted and simplified named arguments documentation, removed redundant headers.
0006-StringInterpolation.md: (Truncated in diff but appears to be reformatted)
0007-PatternMatching.md: (Truncated in diff but appears to be cleaned up)
0008-BlockExpressions.md and beyond: (Changes truncated in diff)
How Do The Automated Tests Prove It Works?
make teststill passes - no functional changes to the language, only documentation improvements.Summarise Changes To The Spec Here
All spec files affected: Removed verbose explanations, excessive emphasis markers (🔥, ✅, ❌), redundant examples, and overly detailed performance sections. Consolidated multi-paragraph explanations into concise descriptions. No functional or semantic changes to the language specification itself.