8000 Formal language spec: define what .nl supports and what it doesn't · Issue #143 · Mnehmos/mnehmos.nls.lang · GitHub
[go: up one dir, main page]

Skip to content

Formal language spec: define what .nl supports and what it doesn't #143

Closed

Description

@Mnehmos

Problem

There is no authoritative document defining the NLS language. Users cannot distinguish a bug from an unsupported feature, and contributors cannot know what is in scope.

Acceptance Criteria

  • docs/LANGUAGE_SPEC.md or equivalent covering: syntax, supported constructs, type system, @use/@main semantics, scoping rules
  • Explicitly lists unsupported/out-of-scope constructs
  • Versioned (spec v0.5 aligns with toolchain v0.5)
  • Error messages reference spec sections where relevant

Why This Blocks v0.5

Without a spec, 'I'd use this for real work' is impossible — users can't know if their code is correct or the compiler is broken.

Activity

  1. added this to the v0.5 milestone on Mar 17, 2026
  2. added
    documentationImprovements or additions to documentation
    specificationLanguage specification documents
    on Mar 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationpriority-highImportant, address soonspecificationLanguage specification documents

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      0