From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on atuin.qyliss.net X-Spam-Level: X-Spam-Status: No, score=-1.7 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,RCVD_IN_DNSWL_LOW,RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL,SPF_HELO_PASS,URIBL_SBL_A autolearn=unavailable autolearn_force=no version=3.4.6 Received: from atuin.qyliss.net (localhost [IPv6:::1]) by atuin.qyliss.net (Postfix) with ESMTP id 82F9B59C25; Mon, 19 Sep 2022 09:30:32 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 496) id 3E93A59C1D; Mon, 19 Sep 2022 09:30:30 +0000 (UTC) Received: from out1-smtp.messagingengine.com (out1-smtp.messagingengine.com [66.111.4.25]) by atuin.qyliss.net (Postfix) with ESMTPS id 6617C59C19 for ; Mon, 19 Sep 2022 09:30:25 +0000 (UTC) Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.nyi.internal (Postfix) with ESMTP id 6BE495C033E; Mon, 19 Sep 2022 05:30:24 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute5.internal (MEProxy); Mon, 19 Sep 2022 05:30:24 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alyssa.is; h=cc :cc:content-type:date:date:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:sender:subject :subject:to:to; s=fm1; t=1663579824; x=1663666224; bh=cT1ycxr1DP J1R8weVa5GmUxx4e01nvjwXbKWVQPLCvk=; b=AC4Rs2phku5gk4I1eJ28X4aBKG CqgkciKpJF7gsD7ytZPW85T51LeyGzeIBgKrBj41AFS1stlRNMqdYC6YZSV2sXdX Ht4HxJIwcEWS1FrOvR+0rmSTxlnzir95h+Sjhoq52/meQI499BU8lnJkY4OBiNAp bn6BEMa+NXJu4LT8rnZvFM0Ozuarm66nfVWdW2SovPa3AJ/j33eqAsuq0PhL3EVJ d77Z5MsyMLozYwH/OefPCXSWGL4azBgXwL9PwY9x7iQ5pgumJOVBwJzIqf/xpreS kAEKQZJJm14NE43mC6+veKblmPi3KeTu0GpaJLPzxvuWgI1IrKzXB8aXvwLQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-type:date:date:feedback-id :feedback-id:from:from:in-reply-to:in-reply-to:message-id :mime-version:references:reply-to:sender:subject:subject:to:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm2; t=1663579824; x=1663666224; bh=cT1ycxr1DPJ1R8weVa5GmUxx4e01 nvjwXbKWVQPLCvk=; b=yOmg4JiKhnMb06RAz3hVUW01Sd1JpJHP3H/SpIiYuHCv kB2puKvVUPN1RBRnGVBekoMZu6xEqX36zCObahGaysCvRZR2OKEklldaEMcEdGIn BW5u88G/7uk3slr13LyovyTPci3tXCpr7E1I5Xj45V56ht8TEWSKLuVPzZb2atC2 XPEoNvdFhB25pwc3JCRsEDGWol+PIfn+cjAOEQjKbUa4WHisJ3znZxakasBV6+mU YLklE6fLqlI6f9qnu3iEdPj/izuyla4knDAkucaYIzaUEVE3CqmC0pHoT1aqzuFi K2+MLssREGbjgtwi6Fh/ydMNLtxeULMVAmbDQWFPxw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrfedvjedgudekucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvvefujghffffkgggtsehgtderredttdejnecuhfhrohhmpeetlhihshhs rgcutfhoshhsuceohhhisegrlhihshhsrgdrihhsqeenucggtffrrghtthgvrhhnpeeuke dtkeehteeiteegffekieevjeejueffgfdvffdtheehgfduvdeutdeuledvfeenucffohhm rghinhepfihikhhiphgvughirgdrohhrghdptghoghhnihhtvggtthdrtghomhdptghloh huugdqhhihphgvrhhvihhsohhrrdhorhhgpdhskhgrrhhnvghtrdhorhhgpdhfrhgvvggu vghskhhtohhprdhorhhgpdgtohguvggsvghrghdrohhrghdpvghtrghlrggsshdrnhgvth dpghhithhhuhgsrdgtohhmpdhgihhtqdhstghmrdgtohhmpdhsphgvtghtrhhumhdqohhs rdhorhhgpdhgihhtqdhsvghnugdqvghmrghilhdrihhopdhgihhtqdhrvggsrghsvgdrih hopdhkvghrnhgvlhdrohhrghdpnhhigihoshdrohhrghenucevlhhushhtvghrufhiiigv pedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehhihesrghlhihsshgrrdhish X-ME-Proxy: Feedback-ID: i12284293:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Mon, 19 Sep 2022 05:30:23 -0400 (EDT) Received: by x220.qyliss.net (Postfix, from userid 1000) id 869029896; Mon, 19 Sep 2022 09:30:21 +0000 (UTC) From: Alyssa Ross To: Jenni Nikolaenko Subject: Re: [PATCH] Docs: new structure In-Reply-To: <20220906135533.576642-1-evgeniia.nikolaenko@unikie.com> References: <20220906135533.576642-1-evgeniia.nikolaenko@unikie.com> Date: Mon, 19 Sep 2022 09:30:17 +0000 Message-ID: <87illjn23a.fsf@alyssa.is> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Message-ID-Hash: 4J2DVKUSXMP5OZ7KIBMTD7ECF6YMLF4K X-Message-ID-Hash: 4J2DVKUSXMP5OZ7KIBMTD7ECF6YMLF4K X-MailFrom: hi@alyssa.is X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1; header-match-devel.spectrum-os.org-0; header-match-devel.spectrum-os.org-1; header-match-devel.spectrum-os.org-2; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: devel@spectrum-os.org X-Mailman-Version: 3.3.5 Precedence: list List-Id: Patches and low-level development discussion Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Jenni Nikolaenko writes: > Create separate folders for new parent pages, update Introduction page, > remove a and the articles from titles, quick check text for simple english > > Signed-off-by: Jenni Nikolaenko > --- Hi Jenni, thank you for the patch! I really love the simple language in the new documentation you've written. I think it'll be a big help to people coming to the project. What did you think about the Di=C3=A1taxis system we were using (well, tryi= ng to use) before? I know we weren't applying it very well =E2=80=94 we defin= itely needed top-level categories about the Di=C3=A1taxis ones so that developer documentation and user documentation weren't mixed together =E2=80=94 but I thought maybe it would still make sense to separate tutorials/how-to/reference/explanation inside those top-level categories. If you don't think it's helpful that's fine =E2=80=94 you're t= he expert! But it was something that was recently called out to me by somebody following the project as a change they were pleased with, so I wanted to check. In future, could you please separate changes like this into a single patch/commit per change? For example, one commit to move the files around, another for the navigation structure changes, and another for the language changes? It makes it much easier to review as it makes it possible to look at each logical change one at a time, it will help to avoid merge conflicts, and it means that some changes can be committed while others are still in discussion, so progress is faster. I've left more feedback inline below. This is a big patch, so there's a lot of feedback =E2=80=94 I hope it's not too intimidating. With more comm= its, where each one was smaller, the reviews would also be a bit more manageable in size! > Documentation/{ =3D> about}/architecture.adoc | 19 ++++----- > Documentation/about/index.adoc | 21 ++++++++++ > .../decisions/001-host-update-mechanism.adoc | 2 +- > .../decisions/002-install-options.adoc | 4 +- > Documentation/decisions/003-partitioning.adoc | 2 +- > .../004-data-at-rest-encryption.adoc | 2 +- > .../005-virtual-machine-monitor.adoc | 2 +- > .../decisions/006-drivers-on-host.adoc | 2 +- > .../decisions/007-usb-virtual-machines.adoc | 2 +- > ...008-inter-vm-communication-mechanisms.adoc | 2 +- > Documentation/decisions/index.adoc | 2 +- > .../building-documentation.adoc | 10 ++--- > .../{ =3D> development}/debugging.adoc | 7 ++-- > .../{ =3D> development}/first-patch.adoc | 28 +++++++------ > Documentation/development/index.adoc | 17 ++++++++ > Documentation/{ =3D> development}/replying.adoc | 4 +- > .../{ =3D> development}/reviewing-patches.adoc | 4 +- > .../{ =3D> development}/testing-patches.adoc | 42 ++++++++----------- > .../{ =3D> development}/uuid-reference.adoc | 4 +- > Documentation/explanation.adoc | 3 +- > .../{ =3D> getting-started}/creating-vms.adoc | 2 +- > Documentation/getting-started/index.adoc | 7 ++++ > .../{ =3D> getting-started}/running-vms.adoc | 2 +- > .../{ =3D> getting-started}/user-partition.adoc | 8 ++-- > Documentation/how-to.adoc | 1 + > Documentation/index.adoc | 22 +++++++--- > Documentation/{ =3D> installation}/b4.adoc | 3 +- > .../{ =3D> installation}/binary-cache.adoc | 11 ++--- > .../{ =3D> installation}/getting-spectrum.adoc | 11 ++--- > Documentation/installation/index.adoc | 18 ++++++++ > Documentation/reference.adoc | 3 +- > Documentation/tutorials.adoc | 3 +- > 32 files changed, 171 insertions(+), 99 deletions(-) > rename Documentation/{ =3D> about}/architecture.adoc (84%) > create mode 100644 Documentation/about/index.adoc > rename Documentation/{ =3D> development}/building-documentation.adoc (85= %) > rename Documentation/{ =3D> development}/debugging.adoc (92%) > rename Documentation/{ =3D> development}/first-patch.adoc (83%) > create mode 100644 Documentation/development/index.adoc > rename Documentation/{ =3D> development}/replying.adoc (93%) > rename Documentation/{ =3D> development}/reviewing-patches.adoc (89%) > rename Documentation/{ =3D> development}/testing-patches.adoc (62%) > rename Documentation/{ =3D> development}/uuid-reference.adoc (98%) > rename Documentation/{ =3D> getting-started}/creating-vms.adoc (98%) > create mode 100644 Documentation/getting-started/index.adoc > rename Documentation/{ =3D> getting-started}/running-vms.adoc (93%) > rename Documentation/{ =3D> getting-started}/user-partition.adoc (80%) > rename Documentation/{ =3D> installation}/b4.adoc (96%) > rename Documentation/{ =3D> installation}/binary-cache.adoc (90%) > rename Documentation/{ =3D> installation}/getting-spectrum.adoc (85%) > create mode 100644 Documentation/installation/index.adoc Thank you for organising the AsciiDoc files into subdirectories. The main Documentation directory was definitely getting a bit unwieldy. > diff --git a/Documentation/architecture.adoc b/Documentation/about/archit= ecture.adoc > similarity index 84% > rename from Documentation/architecture.adoc > rename to Documentation/about/architecture.adoc > index 1c4307b..db82d60 100644 > --- a/Documentation/architecture.adoc > +++ b/Documentation/about/architecture.adoc > @@ -1,17 +1,16 @@ > =3D Architecture > -:page-parent: Explanation > +:page-parent: About Spectrum OS The name of the OS is "Spectrum", not "Spectrum OS". >=20=20 > // SPDX-FileCopyrightText: 2022 Unikie > +// SPDX-FileCopyrightText: 2022 Jenni Nikolaenko Unless you have an agreement otherwise, it's likely that Unikie owns the copyright for these changes, rather than yourself, in which case this would already be covered by the Unikie copyright notice above. (The copyright notice for myself is there because of the work I did on Spectrum prior to working for Unikie.) > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 >=20=20 > -=3D=3D Introduction > +Spectrum OS is based on the principle of security by compartmentalizatio= n. >=20=20 > -Spectrum is based on the principle of security by > -compartmentalization. The high level stack is illustrated in the > -following diagram: > +The high level stack is illustrated in the following diagram: >=20=20 > -image::diagrams/stack.svg[] > +image::../diagrams/stack.svg[] >=20=20 > The default set of virtual machines includes two application VMs, > _appvm-catgirl_ (an IRC client) and _appvm-lynx_ (a text-based web > @@ -26,7 +25,7 @@ https://en.wikipedia.org/wiki/Architectural_decision[Ar= chitecturally significant > decisions] are xref:decisions/index.adoc[recorded] as lightweight > https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions= /[ADRs]. >=20=20 > -=3D=3D The Spectrum host system > +=3D=3D Spectrum Host System >=20=20 > Compartmentalization is implemented using > https://cloud-hypervisor.org/[cloud-hypervisor] virtual machines. > @@ -35,7 +34,7 @@ https://en.wikipedia.org/wiki/Kernel-based_Virtual_Mach= ine[Kernel-based Virtual > Machine] (KVM) to provide lightweight, hardware-accelerated VMs. >=20=20 > While Linux (including KVM) is portable between many hardware architectu= res, > -cloud-hypervisor supports only x86_64 and aarch64. Spectrum currently o= nly > +cloud-hypervisor supports only x86_64 and aarch64. Spectrum currently on= ly The double space after the period here was deliberate =E2=80=94 some people= find it improves readability, and others don't like it, but the reason I've been using it in prose is that it allows text editors to differentiate between the ends of sentences and abbreviations (like "etc."), which means that they can make commands like "move to the next sentence" work accurately even if those abbreviations are used. Do you think there's a reason we should change? > works on x86_64, but aarch64 support is in development. >=20=20 > https://skarnet.org/software/s6-rc/overview.html[s6-rc] is used for serv= ice > @@ -44,7 +43,7 @@ and service scripts. >=20=20 > https://wayland.freedesktop.org/[Wayland] is used for window management = and > display. The Wayland architecture is well documented > -https://wayland.freedesktop.org/architecture.html[here]. The host provi= des only > +https://wayland.freedesktop.org/architecture.html[here]. The host provid= es only > a Wayland terminal client, https://codeberg.org/dnkl/foot/[foot], which = is used > for interacting with VM consoles. In future it will be possible for app= lication > VMs to display windows on the single Wayland compositor on the host syst= em, > @@ -57,7 +56,7 @@ https://www.etalabs.net/compare_libcs.html[added safety= on resource exhaustion > and security hardening on memory allocation]. Kernel hardening will be > investigated in future. >=20=20 > -=3D=3D Exploring the Spectrum dependency tree > +=3D=3D Spectrum Dependency Tree >=20=20 > For a detailed, interactive view of dependencies, use > https://github.com/utdemir/nix-tree[nix-tree] in the Spectrum repository: > diff --git a/Documentation/about/index.adoc b/Documentation/about/index.a= doc > new file mode 100644 > index 0000000..a882852 > --- /dev/null > +++ b/Documentation/about/index.adoc > @@ -0,0 +1,21 @@ > +=3D About Spectrum OS > +:description: Some words about Spectrum as the operating system, not a p= roject. Highlights the differences between common Linux distributions and S= pectrum. I haven't seen this description field before. Where's it used? > +:page-nav_order: 1 > +:page-has_children: true > + > +// SPDX-FileCopyrightText: 2022 Jenni Nikko > +// SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > + > +Spectrum is a Linux-based system, derived from NixOS. This gives an acti= vely-developed base with good hardware support, powerful and optimised comp= artmentalization primitives in KVM, and the reproducible packaging and conf= iguration system that is important for a maintainable compartmentalized sys= tem. It's very subtle, but Spectrum is not really derived from NixOS. Rather, the same packaging tool (Nix) and recipes (Nixpkgs) that are used by NixOS are also used by Spectrum. Also, please keep text hard wrapped at 70-80 characters. (Most editors should be able to do this automatically.) This makes it easier to pick out specific parts in review, and also makes it easier to read in some editors. (It doesn't make a difference to the result as rendered in the web browser.) > + > +=3D=3D Why Spectrum > + > +There are several features that make Spectrum OS unique: > + > +* User data and applications are managed centrally, while remaining isol= ated. > +That means that the system can be backed up and managed as a whole, rath= er than mixed up in several dozen VMs. This is the /goal/, but is not currently the case. Maybe we should say "that will make Spectrum unique", or somehow indicate that in another way? I just wouldn't want anybody to see this in the documentation and then be disappointed to discover that it's not actually (yet) the case. What do you think? > + > +* The host system and isolated environments are managed declaratively an= d reproducibly using the Nix package manager. > +This can save the user the burden of maintaining many different virtual = computers, allowing finer-grained resource access controls and making it po= ssible to verify the software running across all environments. > + > +TIP: If you are interested in why we do something _this_ way instead of = _that_ way, see xref:../decisions/index.adoc[Architecture Decision Records]. Nice tip. That's a great way to describe it. > diff --git a/Documentation/decisions/001-host-update-mechanism.adoc b/Doc= umentation/decisions/001-host-update-mechanism.adoc > index 574deb4..7032146 100644 > --- a/Documentation/decisions/001-host-update-mechanism.adoc > +++ b/Documentation/decisions/001-host-update-mechanism.adoc > @@ -1,6 +1,6 @@ > =3D 001 Host Update Mechanism > :page-parent: Architecture Decision Records > -:page-grand_parent: Explanation > +:page-grand_parent: About Spectrum OS >=20=20 > // SPDX-FileCopyrightText: 2022 Unikie > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/decisions/002-install-options.adoc b/Documenta= tion/decisions/002-install-options.adoc > index 4412b53..a7c4175 100644 > --- a/Documentation/decisions/002-install-options.adoc > +++ b/Documentation/decisions/002-install-options.adoc > @@ -1,6 +1,6 @@ > -=3D 002 Install options > +=3D 002 Install Options > :page-parent: Architecture Decision Records > -:page-grand_parent: Explanation > +:page-grand_parent: About Spectrum OS >=20=20 > // SPDX-FileCopyrightText: 2022 Unikie > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/decisions/003-partitioning.adoc b/Documentatio= n/decisions/003-partitioning.adoc > index 8494ea4..b00f528 100644 > --- a/Documentation/decisions/003-partitioning.adoc > +++ b/Documentation/decisions/003-partitioning.adoc > @@ -1,6 +1,6 @@ > =3D 003 Partitioning > :page-parent: Architecture Decision Records > -:page-grand_parent: Explanation > +:page-grand_parent: About Spectrum OS >=20=20 > // SPDX-FileCopyrightText: 2022 Unikie > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/decisions/004-data-at-rest-encryption.adoc b/D= ocumentation/decisions/004-data-at-rest-encryption.adoc > index 26fe273..27323db 100644 > --- a/Documentation/decisions/004-data-at-rest-encryption.adoc > +++ b/Documentation/decisions/004-data-at-rest-encryption.adoc > @@ -1,6 +1,6 @@ > =3D 004 Data at Rest Encryption > :page-parent: Architecture Decision Records > -:page-grand_parent: Explanation > +:page-grand_parent: About Spectrum OS >=20=20 > // SPDX-FileCopyrightText: 2022 Unikie > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/decisions/005-virtual-machine-monitor.adoc b/D= ocumentation/decisions/005-virtual-machine-monitor.adoc > index db81c72..df5a65e 100644 > --- a/Documentation/decisions/005-virtual-machine-monitor.adoc > +++ b/Documentation/decisions/005-virtual-machine-monitor.adoc > @@ -1,6 +1,6 @@ > =3D 005 Virtual Machine Monitor > :page-parent: Architecture Decision Records > -:page-grand_parent: Explanation > +:page-grand_parent: About Spectrum OS >=20=20 > // SPDX-FileCopyrightText: 2022 Unikie > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/decisions/006-drivers-on-host.adoc b/Documenta= tion/decisions/006-drivers-on-host.adoc > index 872044e..86d3105 100644 > --- a/Documentation/decisions/006-drivers-on-host.adoc > +++ b/Documentation/decisions/006-drivers-on-host.adoc > @@ -1,6 +1,6 @@ > =3D 006 Drivers on Host > :page-parent: Architecture Decision Records > -:page-grand_parent: Explanation > +:page-grand_parent: About Spectrum OS >=20=20 > // SPDX-FileCopyrightText: 2022 Unikie > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/decisions/007-usb-virtual-machines.adoc b/Docu= mentation/decisions/007-usb-virtual-machines.adoc > index 3bdf78b..24dac65 100644 > --- a/Documentation/decisions/007-usb-virtual-machines.adoc > +++ b/Documentation/decisions/007-usb-virtual-machines.adoc > @@ -1,6 +1,6 @@ > =3D 007 USB Virtual Machine > :page-parent: Architecture Decision Records > -:page-grand_parent: Explanation > +:page-grand_parent: About Spectrum OS >=20=20 > // SPDX-FileCopyrightText: 2022 Unikie > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/decisions/008-inter-vm-communication-mechanism= s.adoc b/Documentation/decisions/008-inter-vm-communication-mechanisms.adoc > index a1b7d49..9fce4ef 100644 > --- a/Documentation/decisions/008-inter-vm-communication-mechanisms.adoc > +++ b/Documentation/decisions/008-inter-vm-communication-mechanisms.adoc > @@ -1,6 +1,6 @@ > =3D 008 Inter-VM Communication Mechanisms > :page-parent: Architecture Decision Records > -:page-grand_parent: Explanation > +:page-grand_parent: About Spectrum OS >=20=20 > // SPDX-FileCopyrightText: 2022 Unikie > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/decisions/index.adoc b/Documentation/decisions= /index.adoc > index 772f382..4f3a7e1 100644 > --- a/Documentation/decisions/index.adoc > +++ b/Documentation/decisions/index.adoc > @@ -1,6 +1,6 @@ > =3D Architecture Decision Records > :page-has_children: true > -:page-parent: Explanation > +:page-parent: About Spectrum OS >=20=20 > // SPDX-FileCopyrightText: 2022 Unikie > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/building-documentation.adoc b/Documentation/de= velopment/building-documentation.adoc > similarity index 85% > rename from Documentation/building-documentation.adoc > rename to Documentation/development/building-documentation.adoc > index b491105..da5fa8c 100644 > --- a/Documentation/building-documentation.adoc > +++ b/Documentation/development/building-documentation.adoc > @@ -1,5 +1,5 @@ > -=3D Building the Documentation > -:page-parent: Tutorials > +=3D Building Documentation > +:page-parent: Development >=20=20 > // SPDX-FileCopyrightText: 2022 Unikie > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > @@ -47,6 +47,6 @@ IMPORTANT: Jekyll doesn't handle rendering of the draw.= io diagrams, so > if you modify any of those, or add new ones, you'll have to run > `scripts/build.sh` again to do a full rebuild of the site. >=20=20 > -Once you've made your changes to the documentation, see > -xref:first-patch.adoc[Sending Your First Patch] for information > -about how to submit them for review. > +Once you made your changes to the documentation, see > +xref:first-patch.adoc[Patching] for information > +on how to submit your patch for review. > diff --git a/Documentation/debugging.adoc b/Documentation/development/deb= ugging.adoc > similarity index 92% > rename from Documentation/debugging.adoc > rename to Documentation/development/debugging.adoc > index 3871a7c..6e529a9 100644 > --- a/Documentation/debugging.adoc > +++ b/Documentation/development/debugging.adoc > @@ -1,7 +1,6 @@ > -=3D Debugging Spectrum > -:page-parent: Explanation > -:toc: > -:toclevels: 1 > +=3D Debugging > +:page-parent: Development > +:page-nav_order: 2 >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/first-patch.adoc b/Documentation/development/f= irst-patch.adoc > similarity index 83% > rename from Documentation/first-patch.adoc > rename to Documentation/development/first-patch.adoc > index 30672b9..7b8dd1d 100644 > --- a/Documentation/first-patch.adoc > +++ b/Documentation/development/first-patch.adoc > @@ -1,11 +1,12 @@ > -=3D Sending Your First Patch > -:page-parent: Tutorials > +=3D Patching > +:page-parent: Development > +:page-nav_order: 1 > +:page-has_children: true > +:toc: preamble >=20=20 > // SPDX-FileCopyrightText: 2022 Unikie > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 >=20=20 > -=3D=3D Prerequisites > - > This tutorial assumes that you already have basic > https://git-scm.com/[git] experience. >=20=20 > @@ -14,10 +15,10 @@ https://spectrum-os.org/git/[Spectrum source tree]. = You'll also need > to have configured `git send-email` =E2=80=94 a guide for this can be fo= und at > https://git-send-email.io/. >=20=20 > -=3D=3D Making your changes > +=3D=3D Making Changes >=20=20 > -If you've worked on any git repository before, the process for making > -your changes will probably be very familiar. > +If you worked on any git repository before, the process for making > +your changes will be very familiar. Hmm, "If you worked" doesn't sound correct to me. I think it's the wrong tense? Maybe "you have", if you want it to sound less informal than "you've"? >=20=20 > 1. Create a branch for your changes: > + > @@ -39,7 +40,7 @@ indicates your acceptance of the > https://spectrum-os.org/git/spectrum/tree/DCO-1.1.txt[Developer's > Certificate of Origin], which is mandatory for Spectrum patches. >=20=20 > -=3D=3D Submitting changes > +=3D=3D Submitting Changes >=20=20 > Once you're happy with how the commits on your branch look, run: >=20=20 > @@ -64,13 +65,14 @@ message that will be sent before all of your patches. >=20=20 > Once your patch has been submitted, wait for it to be reviewed. > Feedback, if any, will be sent as email replies to your submitted > -patch. You can respond to feedback in your mail client. Please use > -the Reply All button to ensure that your messages are sent to the > +patch. You can respond to feedback in your mail client. > + > +Use the *Reply All* button to sent your messages to the > mailing list as well as to the person who sent the feedback. >=20=20 > -If you need to make changes to your patch, and submit a new version, > +If you need to make changes to your patch and submit a new version, > use https://git-rebase.io/[`git rebase`] to create a new version of > -your patch(es), and submit it like this: > +your patch(es) and then submit it like this: Good catch with the commas, thanks. >=20=20 > [source,shell] > ---- > @@ -81,7 +83,7 @@ The added `-v2` flag indicates that this is version two= of your > patch set. If your patches require more rounds of changes, submit > subsequent rounds with `-v3`, `-v4`, etc. as appropriate. >=20=20 > -If you'd like to describe what has changed from the previous version > +If you would like to describe what has changed from the previous version > of your patches, you can do so in a xref:cover-letter[cover letter] > as described above. >=20=20 > diff --git a/Documentation/development/index.adoc b/Documentation/develop= ment/index.adoc > new file mode 100644 > index 0000000..471daf7 > --- /dev/null > +++ b/Documentation/development/index.adoc > @@ -0,0 +1,17 @@ > +=3D Development > +:description: Development progress, general development practices > +:page-nav_order: 4 > +:page-has_children: true > + > +// SPDX-FileCopyrightText: 2022 Jenni Nikko > +// SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > + > +Spectrum is free software, currently under active development. > + > +=3D=3D Developer Setup > + > +Before starting, make sure you are familiar with https://git.kernel.org/= pub/scm/utils/b4/b4.git/about/[b4] and the https://nixos.org/manual/nix/sta= ble/introduction.html[Nix package manager]. > + > +=3D=3D Mailing Lists > + > +The Spectrum project runs several https://spectrum-os.org/mailman3/lists= /?all-lists[mailing lists] on which you can ask your questions or help othe= r people with the questions they have. All the Spectrum developers as well = as many long time Linux and Spectrum users are on the lists. If we're telling people where they can ask questions, might also be good to mention the IRC/Matrix channel? People seem to mostly prefer that for quick questions, since it's realtime. > diff --git a/Documentation/replying.adoc b/Documentation/development/repl= ying.adoc > similarity index 93% > rename from Documentation/replying.adoc > rename to Documentation/development/replying.adoc > index bb8e31a..05740a0 100644 > --- a/Documentation/replying.adoc > +++ b/Documentation/development/replying.adoc > @@ -1,5 +1,7 @@ > =3D Replying to Messages in the Mailing List Archives > -:page-parent: Tutorials > +:page-parent: Patching > +:page-grand_parent: Development > +:page-nav_order: 3 >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/reviewing-patches.adoc b/Documentation/develop= ment/reviewing-patches.adoc > similarity index 89% > rename from Documentation/reviewing-patches.adoc > rename to Documentation/development/reviewing-patches.adoc > index 63ff24e..c8c971f 100644 > --- a/Documentation/reviewing-patches.adoc > +++ b/Documentation/development/reviewing-patches.adoc > @@ -1,5 +1,7 @@ > =3D Reviewing Patches > -:page-parent: How-to Guides > +:page-parent: Patching > +:page-grand_parent: Development > +:page-nav_order: 2 >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/testing-patches.adoc b/Documentation/developme= nt/testing-patches.adoc > similarity index 62% > rename from Documentation/testing-patches.adoc > rename to Documentation/development/testing-patches.adoc > index 8ba7804..99adfd2 100644 > --- a/Documentation/testing-patches.adoc > +++ b/Documentation/development/testing-patches.adoc > @@ -1,5 +1,8 @@ > =3D Testing Patches > -:page-parent: How-to Guides > +:page-parent: Patching > +:page-grand_parent: Development > +:page-nav_order: 1 > +:toc: preamble >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > @@ -8,52 +11,41 @@ Potential changes to Spectrum are posted to and discus= sed on the > https://spectrum-os.org/participating.html#spectrum-devel[devel@spectrum= -os.org] > mailing list. >=20=20 > -=3D=3D Apply the patch > +=3D=3D Apply Patch >=20=20 > If you haven't already, you'll first need to xref:b4.adoc[install and > configure] https://git.kernel.org/pub/scm/utils/b4/b4.git/about/[b4]. > Then: >=20=20 > -. Find the patch series you want to test on > - https://spectrum-os.org/lists/archives/spectrum-devel/[public-inbox]. > -. Navigate to the "permalink" page for any patch in the series. > -. Copy the Message-Id for the patch, as shown on the permalink page, e.g. > - \20220511092352.70E54C980@atuin.qyliss.net. > -. In a checkout of the appropriate git repository > - (https://spectrum-os.org/git/spectrum[Spectrum] or > - https://spectrum-os.org/git/nixpkgs[Spectrum Nixpkgs]), Run `b4 am` > - with the patch's Message-Id to download all the patches in the > - series into a file. > +1. Find the patch series you want to test on https://spectrum-os.org/lis= ts/archives/spectrum-devel/[public-inbox]. > +2. Navigate to the "permalink" page for any patch in the series. > +3. Copy the Message-Id for the patch, as shown on the permalink page, e.= g. \20220511092352.70E54C980@atuin.qyliss.net. > +4. In a checkout of the appropriate git repository (https://spectrum-o= s.org/git/spectrum[Spectrum] or https://spectrum-os.org/git/nixpkgs[Spect= rum Nixpkgs]), run `b4 am` with the patch's Message-Id to download all the = patches in the series into a file. Hmm, why add explicit numbers here? They'll be automatically inserted by Asciidoctor, but not writing them manually in the source means that the writer doesn't have to manually renumber things if they add something in the middle of the list of move things around? > + > -[example] The example attribute (when used without a title) doesn't currently make any difference in output/styling, but I think it's useful to use anyway in case we want to e.g. label examples in future. > [source,shell] > ---- > b4 am 20220511092352.70E54C980@atuin.qyliss.net > ---- > - > -. b4 will indicate the file name it has downloaded the patches into > - with a line like: > +b4 will indicate the file name it has downloaded the patches into with a= line like: > + > -[example] > -[listing] > +[source,shell] > +---- > Writing ./20220424_hi_host_rootfs_fix_weston_hotplugging.mbx > +---- This is just sample text output from git, not shell source code. > +5. Run `git am` on that file to apply the patches, for example: > + > -Run `git am` on that file to apply the patches, for example: > -+ > -[example] > [source,shell] > ---- > git am 20220424_hi_host_rootfs_fix_weston_hotplugging.mbx > ---- >=20=20 > -=3D=3D Post your test results > +=3D=3D Post Your Results >=20=20 > When you've tested a patch, it's really helpful to > xref:replying.adoc[reply] with your test results. >=20=20 > -If the patch worked for you, please reply to it and include a line > -like the following, separated from any reply text: > - > +If the patch worked for you, please reply to it and include a line like = the following, separated from any reply text: > +[source,shell] > ---- > Tested-by: John Smith > ---- > diff --git a/Documentation/uuid-reference.adoc b/Documentation/developmen= t/uuid-reference.adoc > similarity index 98% > rename from Documentation/uuid-reference.adoc > rename to Documentation/development/uuid-reference.adoc > index 4b0b481..0eccc82 100644 > --- a/Documentation/uuid-reference.adoc > +++ b/Documentation/development/uuid-reference.adoc > @@ -1,5 +1,5 @@ > =3D UUID Reference > -:page-parent: Reference > +:page-parent: Development > :toc: preamble > :toclevels: 1 >=20=20 > @@ -40,7 +40,7 @@ xref:user-partition.adoc[Spectrum user partition]. >=20=20 > =3D=3D=3D `56a3bbc3-aefa-43d9-a64d-7b3fd59bbc4e` >=20=20 > -https://github.com/endlessm/eos-installer["eosimages"] partition on the= =20 > +https://github.com/endlessm/eos-installer["eosimages"] partition on the > Spectrum combined live system / installer image. >=20=20 > =3D=3D Combined Image Partition IDs > diff --git a/Documentation/explanation.adoc b/Documentation/explanation.a= doc > index b39cc6d..f682129 100644 > --- a/Documentation/explanation.adoc > +++ b/Documentation/explanation.adoc > @@ -1,6 +1,5 @@ > =3D Explanation > -:page-has_children: true > -:page-nav_order: 4 > +:page-nav_exclude: true >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/creating-vms.adoc b/Documentation/getting-star= ted/creating-vms.adoc > similarity index 98% > rename from Documentation/creating-vms.adoc > rename to Documentation/getting-started/creating-vms.adoc > index d967098..e06be85 100644 > --- a/Documentation/creating-vms.adoc > +++ b/Documentation/getting-started/creating-vms.adoc > @@ -1,5 +1,5 @@ > =3D Creating VMs > -:page-parent: Reference > +:page-parent: Getting Started >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/getting-started/index.adoc b/Documentation/get= ting-started/index.adoc > new file mode 100644 > index 0000000..1b468ab > --- /dev/null > +++ b/Documentation/getting-started/index.adoc > @@ -0,0 +1,7 @@ > +=3D Getting Started > +:description: Exploring Spectrum OS. Using (=3DHow-To-Guides), Configuri= ng (adding smth). Ready to get started with Spectrum OS? After installing y= ou can create VMs and then configure each one. > +:page-nav_order: 3 > +:page-has_children: true > + > +// SPDX-FileCopyrightText: 2022 Jenni Nikko > +// SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/running-vms.adoc b/Documentation/getting-start= ed/running-vms.adoc > similarity index 93% > rename from Documentation/running-vms.adoc > rename to Documentation/getting-started/running-vms.adoc > index d0d3f99..9073e3c 100644 > --- a/Documentation/running-vms.adoc > +++ b/Documentation/getting-started/running-vms.adoc > @@ -1,5 +1,5 @@ > =3D Running VMs > -:page-parent: Reference > +:page-parent: Getting Started >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/user-partition.adoc b/Documentation/getting-st= arted/user-partition.adoc > similarity index 80% > rename from Documentation/user-partition.adoc > rename to Documentation/getting-started/user-partition.adoc > index 73bc0d0..a33d7fc 100644 > --- a/Documentation/user-partition.adoc > +++ b/Documentation/getting-started/user-partition.adoc > @@ -1,11 +1,13 @@ > -=3D The User Partition > -:page-parent: Explanation > +=3D User Partition > +:page-parent: Getting Started >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 >=20=20 > The Spectrum host system is immutable, so configuration and user data > -lives on a separate partition. The host system discovers the user > +lives on a separate partition. > + > +The host system discovers the user > partition by looking for the special partition type > `9293e1ff-cee4-4658-88be-898ec863944f`. This behavior can be > overridden with the `ext` parameter on the host's kernel command line, > diff --git a/Documentation/how-to.adoc b/Documentation/how-to.adoc > index f43fa13..98cc842 100644 > --- a/Documentation/how-to.adoc > +++ b/Documentation/how-to.adoc > @@ -1,4 +1,5 @@ > =3D How-to Guides > +:page-nav_exclude: true > :page-has_children: true > :page-nav_order: 2 >=20=20 > diff --git a/Documentation/index.adoc b/Documentation/index.adoc > index 3079847..d26676b 100644 > --- a/Documentation/index.adoc > +++ b/Documentation/index.adoc > @@ -1,13 +1,23 @@ > -=3D Spectrum Docs > +=3D Spectrum Documentation > :page-nav_exclude: true >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > +// SPDX-FileCopyrightText: 2022 Jenni Nikolaenko > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 >=20=20 > -Spectrum is a compartmentalized operating system. > +=3D=3D Spectrum Project >=20=20 > -If you'd like to try Spectrum, see xref:getting-spectrum.adoc[Getting > -Spectrum]. > +Spectrum is an open source project that aims to create a computer operat= ing system, based on the principle of security by compartmentalization, tha= t has a lower barrier to entry and is easier to use and maintain than other= such systems. For more information on the Spectrum project, see https://sp= ectrum-os.org/. If the only comparison we draw to other systems is that Spectrum is trying to be easier to use, I'm worried that would give the impression that that's the only interesting thing about Spectrum, and e.g. put people off that don't find what they're currently using to be too hard to use. e.g. other reasons people might want to use Spectrum are that we will have wider hardware support through the ARM port Unikie is working on, and that we have security features other similar systems don't have (although we can't just claim to be *more* secure, since there will be other things they do better than us). But I also understand that this is just a short introductory sentence, so we can't go into too much detail. >=20=20 > -To learn about what Spectrum is and how it's implemented, start with > -the xref:architecture.adoc[architecture overview]. > +Spectrum is made of free and open source software. It is free for anyone= to use, modify, and distribute. If you want to be involved with the Spectr= um project, see https://spectrum-os.org/contributing.html. > + > +The Spectrum project source code is https://spectrum-os.org/git/spectrum. > + > +=3D=3D Spectrum OS > + > +Spectrum is an in-development operating system that aims to afford its u= sers security by compartmentalization, while also improving upon other simi= lar projects by maintaining a high level of usability. This is quite similar to the sentence at the start of this page. Maybe it doesn't make sense (yet) to try to distinguish Spectrum the project from Spectrum the operating system? > + > +To learn about what Spectrum OS is and how it's implemented, start with > +the xref:about/architecture.adoc[architecture overview]. > + > +If you want to try Spectrum, see xref:../installation/index.adoc[Build a= nd Run]. > diff --git a/Documentation/b4.adoc b/Documentation/installation/b4.adoc > similarity index 96% > rename from Documentation/b4.adoc > rename to Documentation/installation/b4.adoc > index 2519894..1ba87b2 100644 > --- a/Documentation/b4.adoc > +++ b/Documentation/installation/b4.adoc > @@ -1,5 +1,6 @@ > =3D Installing and Configuring b4 > -:page-parent: Tutorials > +:page-parent: Build and Run > +:page-nav_order: 3 >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/binary-cache.adoc b/Documentation/installation= /binary-cache.adoc > similarity index 90% > rename from Documentation/binary-cache.adoc > rename to Documentation/installation/binary-cache.adoc > index 6e69b39..232f96c 100644 > --- a/Documentation/binary-cache.adoc > +++ b/Documentation/installation/binary-cache.adoc > @@ -1,10 +1,11 @@ > -=3D Setting Up the Binary Cache > -:page-parent: How-to Guides > +=3D Setting Up Binary Cache > +:page-parent: Build and Run > +:page-nav_order: 1 >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 >=20=20 > -Building Spectrum from source can take a very long time. To avoid > +Building Spectrum OS from source can take a very long time. To avoid > having to wait when building the system to try it out or test patches, > an x86_64 binary cache service is available. If configured to do so, > Nix will download build outputs from the cache, instead of building > @@ -20,7 +21,7 @@ encounter any trouble with it. > The binary cache is currently not able to provide logs, due to a > https://github.com/NixOS/nix/pull/6051[Nix bug]. >=20=20 > -=3D=3D On NixOS > +=3D=3D For NixOS >=20=20 > The following configuration adds the Spectrum binary cache as a > substituter, and tells Nix to trust builds signed with its public key. > @@ -38,7 +39,7 @@ substituter, and tells Nix to trust builds signed with = its public key. > } > ---- >=20=20 > -=3D=3D On Non-NixOS systems > +=3D=3D For Non-NixOS Systems >=20=20 > Add the following configuration to /etc/nix/nix.conf: >=20=20 > diff --git a/Documentation/getting-spectrum.adoc b/Documentation/installa= tion/getting-spectrum.adoc > similarity index 85% > rename from Documentation/getting-spectrum.adoc > rename to Documentation/installation/getting-spectrum.adoc > index b3fa1ef..a0ea1c4 100644 > --- a/Documentation/getting-spectrum.adoc > +++ b/Documentation/installation/getting-spectrum.adoc > @@ -1,10 +1,11 @@ > =3D Getting Spectrum > -:page-parent: Tutorials > +:page-parent: Build and Run > +:page-nav_order: 2 >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 >=20=20 > -To get Spectrum, you need to build it from source. As long as you're > +To get Spectrum OS, you need to build it from source. As long as you're > running Linuxfootnote:[Building from other operating systems might > work, but hasn't been tested. Patches are welcome to support building > from other operating systems, as long as they're not too invasive.] > @@ -17,7 +18,7 @@ lot of time waiting for builds. >=20=20 > =3D=3D Trying Spectrum >=20=20 > -If you want to try Spectrum out to get a feel for it, without > +If you want to try Spectrum OS out to get a feel for it, without > installing it, you can run it in a development VM with some example > applications. >=20=20 > @@ -34,7 +35,7 @@ nix-shell -I nixpkgs=3D../../../nixpkgs-spectrum --run = 'make run' > This builds just enough of Spectrum to try it out in a VM, but it will > still take a very long time. >=20=20 > -=3D=3D Building an installer > +=3D=3D Building Installer >=20=20 > [source,shell] > ---- > @@ -48,7 +49,7 @@ named "result" will appear, pointing to a Spectrum USB = installer > image. >=20=20 > CAUTION: Spectrum is not yet suitable for real-world use. Do not use > -your Spectrum system for anything important or sensitive. Spectrum is > +your Spectrum OS for anything important or sensitive. Spectrum is > currently missing many important security properties, and there is no > procedure for updating to new versions of Spectrum -- you have to > reinstall. > diff --git a/Documentation/installation/index.adoc b/Documentation/instal= lation/index.adoc > new file mode 100644 > index 0000000..99e9723 > --- /dev/null > +++ b/Documentation/installation/index.adoc > @@ -0,0 +1,18 @@ > +=3D Build and Run > +:description: How to download and install Spectrum OS. > +:page-nav_order: 2 > +:page-has_children: true > + > +// SPDX-FileCopyrightText: 2022 Jenni Nikko > +// SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > + > +To try Spectrum OS out or xref:../development/testing-patches.adoc[test = patches], you need to build the system from the source. > + > +In order to speed up the build process, set up the binary cache. After b= uilding Spectrum OS, you can install and configure the b4 utility to be abl= e to work with patches. > + > + > +TIP: Note that Spectrum OS currently works only on x86-64. AAarch64 supp= ort is in development. > + > +Currently, there is no implementation for a software update. > + > +You can replace the installation with some other OS. The information on this page feels very similar to the information on the "Getting Spectrum" page. Do you think we need both? > diff --git a/Documentation/reference.adoc b/Documentation/reference.adoc > index 44b359d..55259ea 100644 > --- a/Documentation/reference.adoc > +++ b/Documentation/reference.adoc > @@ -1,6 +1,5 @@ > =3D Reference > -:page-has_children: true > -:page-nav_order: 3 > +:page-nav_exclude: true >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > diff --git a/Documentation/tutorials.adoc b/Documentation/tutorials.adoc > index cd1fb12..fcef31b 100644 > --- a/Documentation/tutorials.adoc > +++ b/Documentation/tutorials.adoc > @@ -1,6 +1,5 @@ > =3D Tutorials > -:page-nav_order: 1 > -:page-has_children: true > +:page-nav_exclude: true >=20=20 > // SPDX-FileCopyrightText: 2022 Alyssa Ross > // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-= 4.0 > --=20 > 2.34.1 --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEH9wgcxqlHM/ARR3h+dvtSFmyccAFAmMoNqoACgkQ+dvtSFmy ccCFThAAm2k1BTt45hEaaId7sEZs8DYwiqHXpEZBVh3yumgQe27I0lVmqLXKU/iD wm1ttCRevAoilYD9Mn94noh0bbfg9ienAW72qTzWMGLv9mWWyMhgQXf4Xn6e1q/M Io8ElpXMtyg/5KidzqfStb6/sW9eROpXS91Jy32SdHhyWWSYYh8+rpNp55zlJP+y oDt643QoCr75Cd1VqKSS4iY7JSFy9kO5Tn1LF6ulr1SGjlo+2zg/EZQONgRLjqdU /ODVc83wdPvDZvH2lHyf2IV9pqy/oDjSRumPLo85Inlvpg//Hl1GlWWs3A3Q4qs0 XvkoR6MBQBopvVVLV9Zbkp7Efbe0kXfo6Go8yNkA2RgZpvTOhXaodbK6lzQSiJ1U vxQGxe7KzptrJV0K1zq2iQNHMLYlKGNaN+ONTAO99jY63SDEyCyJQAs9FnYwL5FY nOGzOuJESgDzeREB9ckvHJrSVZHVDHEflQL8B8ghNjpclYP2SBXnoNaWlQuDHoQ6 qVfWxABr7PERtxv6SinkDtVMbYhy5JTPlEtpnlDrz8biMeXfPjic96qYzH3S+SNL w9FKnSPBH312WqYGBqFv+CGgozs8LKKv2CWTgWzoWxCb7CVwynF538mFVdTDDjrv Ig2ND4tmb7X7vwC6Xxztz0SIp8vRUv6TVVtLXs7r87bqs4g0Wn4= =vwF+ -----END PGP SIGNATURE----- --=-=-=--