search

hilbix / L

Minimalistic Embedded Language
Other
0 stars 0 forks source link

missing `VERSION` #8

Open hilbix opened 2 years ago

hilbix commented 2 years ago

Currently L has no VERSION. There should be a version.

hilbix commented 2 years ago

Versioning will become MAJOR.MINOR.PATCH as usual.

As things are not stable yet, we are currently at 0.1.0

MAJOR will reflect language changes. So if some feature is incompatibly changed, MAJOR number will be incremented. Do not expect programs for one MAJOR number to run on another MAJOR number unchanged. This also is the version of the default PARSER used (in case we get more than one parser).

MINOR will reflect nonbreaking updates or bug fixes. This might render some incompatibilites to programs, which relied on the bug. In future there might be a way to specify compatibility mode for programs to select a specific behavior of some MAJOR.MINOR version.

PATCH will reflect nonbreaking updates or fixes which do not have sideeffects, like updates to README or documentation or Build/Test scripts. Also if new functions are introduced or function behavior is extended, this cannot affect existing programs, so this will be on PATCH level.

So you can always upgrade to the latest PATCH level.

On MINOR updates everything still shall work and bugs or wrong behavior should go away, except if you rely on a bug.

On MAJOR you probably have to rewrite your programs to make them compatible again.