1.0

[casey]

Just 1.0 will be released on 2022-01-01 (jk, now aiming for 2022-02-22). The main "feature" of 1.0 will be a strong commitment to stability. This includes:

• Source compatibility. Justfiles won't stop compiling in any future release.
• Semantic compatibility. Justfiles won't work differently in any future release.
• Invocation compatibility. Just command-line invocations won't change or break with any future release.
• No successor. If there are any highly desirable breaking changes, they will be introduced in a backwards compatible way similar to Rust's edition system.

There will be one backwards incompatible change:

• Consider requiring a statement in justfile to load .env file #469 Requiring set dotenv-load := true to load .env files

Another backwards incompatible change that is being contemplated is removing all use of cygpath on Windows. See #984 for an example of how the current behavior is confusing.

Other backwards incompatible changes that were considered, but abandoned, are:

• Differentiate documentation and non-documentation comment syntax #495 Differentiate doc-comment syntax. This would be nice, but there isn't huge demand for it, and it would be highly disruptive.
• Consider making set positional-arguments := true the default #808 Consider making set positional-arguments := true the default. This would be nice, but it breaks powershell, and possibly other non-Bourne shells, making it highly disruptive.

After 1.0 is released, I should make the version prominent in the readme, and also document the stability commitment in the readme.