Skip to content

Expand language evolution notes for contributors #7

Description

@DKFuH

Why

OrgScript now needs clearer guidance for what belongs in the language core and how future changes should be evaluated.

Scope

  • define what is considered a core language change
  • define what should stay in tooling or exporters
  • document how breaking changes are handled
  • explain how spec evolution and CLI evolution should be coordinated

Definition Of Done

  • contributors can understand how language changes are evaluated

  • breaking changes are treated explicitly instead of implicitly

  • the governance story is clearer than today

  • v0.5.0

  • documentation

  • governance

  • existing governance notes

  • canonical language spec

Keep the process lightweight. This should guide decisions, not slow them down.

Activity

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 documentationgovernancelanguage evolution, compatibility, and change-management guidancehelp wantedExtra attention is needed

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions