commit 5d810dbbbd72899c20da9cb67e67d67be08c1045
parent ead6cb918a904a26f3edbbf3af5503b870d1b54f
Author: Daniel Barlow <dan@telent.net>
Date: Tue, 28 Oct 2025 23:39:57 +0000
README should probably not stil claim we're pre-1.0
Diffstat:
1 file changed, 14 insertions(+), 4 deletions(-)
diff --git a/README.md b/README.md
@@ -16,9 +16,19 @@ outside word goes across it.
## Current status (does it work yet?)
-Liminix is pre-1.0. We are still finding new and better ways to do things,
-and there is no attempt to maintain backward compatibility with the old
-ways.
+Liminix 1.0 was released in April 2025. It works for me and I would
+say it has seen lots of use in the particular applications of "home
+wifi router" and "wireless extender".
+
+It's not “finished” - we are still finding new and better ways to do
+things - but we endeavour to signal future breaking changes through the
+version number. This is “semver-adjacent”, in that minor bumps
+(1.1, 1.2 …) are used for minor new features and major bumps (2.0 …)
+for changes that are likely to break out-of-tree modules or
+configurations. It won’t be semver exactly because [every change
+breaks someone’s workflow](https://xkcd.com/1172/), but we aspire to
+have the magnitude of the version delta correlate with the scale of
+the consequences of upgrading.
The [NEWS](NEWS) file (available wherever you found this README) is
a high-level overview of breaking changes.
@@ -33,7 +43,7 @@ functioning version, see [the CI system](https://build.liminix.org/jobset/limini
Documentation is in the [doc](doc/) directory. You can build it
by running
- nix-shell -p sphinx --run "make -C doc hardware.rst html"
+ nix-build -I liminix=`pwd` ci.nix -A doc
Rendered documentation corresponding to the latest commit on `main`
is published to [https://www.liminix.org/doc/](https://www.liminix.org/doc/)
