From: Valentin Gagarin <valentin@gagarin.work>
To: devel@spectrum-os.org
Cc: Valentin Gagarin <valentin@gagarin.work>
Subject: [PATCH] Documentation: reword the distinctive feature of shared state
Date: Wed, 17 Jun 2026 15:24:14 +0200 [thread overview]
Message-ID: <20260617132414.103828-1-valentin@gagarin.work> (raw)
This changes front-page wording in load-bearing ways, for reasons that
may be non-obvious:
- Split into shorter sentences
Each one is focused on describing a separate idea. The second idea is
more complex and warrants more words, so having a dedicated sentence
avoids losing the reader.
- s/several dozen/many/
The particular number doesn't matter, and may be arbitrarily wrong in
practice. The point is that there's fragmentation. The snark about
any large number is unnecessary if we put the real problem in the
foreground.
- s/mixed up in//
It could be that entanglement is an issue, but fragmentation seems to
be the bigger issue. In any case, the original sentence was awkward
grammatically, because it tried putting together how a system is
handled with what the system is like.
- s/managed as a whole/still treated as a whole/
We're already saying "managed" in the first sentence. Managing
the system is very different from managing state. We need to be
careful with using words without prior definitions, so the best we can
do here is avoid inadvertent conflation. There is enough potential
for confusion as it is.
"still" acknowledges the traditional single-system experience that
Spectrum preserves by design.
- s/backed up and//
The difficulty of backing up is a specific instance of the
fragmentation problem. But this is likely only evident to Qubes
users. We can expect most readers to know about it theoretically at
best. While it's not wrong to have this sort of anchor, keeping it
risks diluting the main message.
- "each becoming a system of its own"
This captures the Qubes failure mode Spectrum avoids, where per-VM state
accumulation forces operators into what amounts to orchestrating
a cluster on one's desktop.
In the original, the contrast to Qubes would not be as strong for
people only familiar with it superficially. Being more explicit about
the nature of the problem helps establishing the narrative frame and
original motivation of Spectrum early on, part of which is overcoming
Qubes limitations.
---
Documentation/index.html | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/Documentation/index.html b/Documentation/index.html
index 6d6faf7..0ea0a2f 100644
--- a/Documentation/index.html
+++ b/Documentation/index.html
@@ -23,9 +23,9 @@ such systems.
<p>
User data and application state will be managed centrally, while
-remaining isolated, meaning that the system can be backed up and
-managed as a whole, rather than mixed up in several dozen virtual
-machines.
+remaining isolated. This means that the system can be
+treated as a whole, rather than many virtual
+machines each becoming a system of its own.
<p>
Spectrum is an upstream-first project. Wherever possible, we aim to
--
2.54.0
next reply other threads:[~2026-06-17 13:24 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-06-17 13:24 Valentin Gagarin [this message]
2026-06-17 16:55 ` [PATCH] Documentation: reword the distinctive feature of shared state Alyssa Ross
2026-06-17 19:40 ` Valentin Gagarin
2026-06-19 14:54 ` Alyssa Ross
2026-06-22 9:55 ` [PATCH v2 1/2] " Valentin Gagarin
2026-06-22 9:55 ` [PATCH v2 2/2] Documentation: sketch the threat model on the front page Valentin Gagarin
2026-06-22 13:26 ` Alyssa Ross
2026-06-22 17:55 ` Valentin Gagarin
2026-06-24 8:57 ` Alyssa Ross
2026-06-24 12:18 ` Alyssa Ross
2026-06-22 13:24 ` [PATCH v2 1/2] Documentation: reword the distinctive feature of shared state Alyssa Ross
2026-06-22 13:28 ` Alyssa Ross
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260617132414.103828-1-valentin@gagarin.work \
--to=valentin@gagarin.work \
--cc=devel@spectrum-os.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://spectrum-os.org/git/crosvm
https://spectrum-os.org/git/doc
https://spectrum-os.org/git/mktuntap
https://spectrum-os.org/git/nixpkgs
https://spectrum-os.org/git/spectrum
https://spectrum-os.org/git/ucspi-vsock
https://spectrum-os.org/git/www
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).