atomic-desktops/docs
10
4
Fork 8
Code Issues 4 Pull requests 1 Activity

Convert to a Fedora Atomic Desktops docs

Browse source
This commit is contained in:
Timothée Ravier 2024-07-01 17:25:19 +02:00
commit 87c7dff411
4 changed files with 30 additions and 22 deletions
Download patch file Download diff file Expand all files Collapse all files

4
README.md
View file

@ -1,6 +1,6 @@
# Fedora Silverblue Documentation
# Fedora Atomic Desktops Documentation
This repository contains the Fedora Silverblue documentation.
This repository contains the Fedora Atomic Desktops documentation.
## Structure

4
antora.yml
View file

@ -2,10 +2,10 @@
# Tip: If you want to use the local preview scripts that come with this
# repository, please change this value in the site.yml file as well (under
# site/start_page)
name: fedora-silverblue
name: fedora-atomic-desktops
# Title will be visible on the page.
title: Fedora Silverblue
title: Fedora Atomic Desktops
# If you don't plan to have multiple versions of the docs (for example, to
# document multiple versions of some software), you can ignore this field.

42
modules/ROOT/pages/index.adoc
View file

@ -1,40 +1,48 @@
= {variant-name} User Guide
= Fedora Atomic Desktops User Guide
Welcome to the {variant-name} user guide!
Welcome to the user guide for the Fedora Atomic Desktops!
This guide covers all the Fedora Atomic Desktops: Silverblue, Kinoite, Sway Atomic (was Sericea), Budgie Atomic (was Onyx).
image::silverblue-logo.svg[{variant-name} logo]
_{variant-name}_ is an immutable desktop operating system.
It aims to be extremely stable and reliable.
It also aims to be an excellent platform for developers and for those using container-focused workflows.
_Fedora Atomic Desktops_ are image based desktop operating system.
They aim to be extremely stable and reliable.
They also aim to be an excellent platform for developers and for those using container-focused workflows.
[[introduction]]
== Introduction to {variant-name}
== Introduction to Fedora Atomic Desktops
{variant-name} is a variant of {variant-classic}.
It looks, feels and behaves like a regular desktop operating system, and the experience is similar to what you find with using a standard {variant-classic}.
In general, Fedora Atomic Destkops are miage based variants of their Fedora Linux (package mode) versions:
However, unlike other operating systems, {variant-name} is immutable.
- Fedora Silverblue is a variant of Fedora Workstation.
- Fedora Kinoite is a variant of Fedora KDE Spin.
- Fedora Sway Atomic is a variant of Fedora Sway Spin.
- Fedora Budgie Atomic is a varinat of Fedora Budgie Spin.
They look, feel and behave like a regular desktop operating system, and the experience is similar to what you find with using a standard (package mode) Fedora Linux system.
However, unlike other operating systems, Fedora Atomic Desktops are image based (sometimes also called *immutable*).
This means that every installation is identical to every other installation of the same version.
The operating system that is on disk is exactly the same from one machine to the next, and it never changes as it is used.
{variant-name}'s immutable design is intended to make it more stable, less prone to bugs, and easier to test and develop.
Finally, {variant-name}'s immutable design also makes it an excellent platform for containerized applications as well as container-based software development.
Fedora Atomic Desktops' image based design is intended to make it more stable, less prone to bugs, and easier to test and develop.
Finally, Fedora Atomic Desktops' design also makes it an excellent platform for containerized applications as well as container-based software development.
In each case, applications (apps) and containers are kept separate from the host system, improving stability and reliability.
{variant-name}'s core technologies have some other helpful features.
OS updates are fast and there's no waiting around for them to install: just reboot as normal to start using the next version.
With {variant-name}, it is also possible to roll back to the previous version of the operating system, if something goes wrong.
Fedora Atomic Desktops' core technologies have some other helpful features.
Operating system updates are fast and there's no waiting around for them to install: just reboot as normal to start using the next version.
With Fedora Atomic Desktops, it is also possible to roll back to the previous version of the operating system if something goes wrong.
[[this-guide]]
== About this guide
In most cases, {variant-name} behaves like a standard {variant-classic} installation, and the https://docs.fedoraproject.org/[standard Fedora documentation] can be used.
This guide covers those areas where {variant-name} differs from a standard {variant-classic}, including:
In most cases, Fedora Atomic Desktops behave like a standard (package mode) Fedora Linux installation, and the https://docs.fedoraproject.org/[general Fedora documentation] can be used.
This guide covers the areas where Fedora Atomic Desktops differ from a standard Fedora Linux system, including:
* xref:installation.adoc[OS installation]
* xref:getting-started.adoc[Installing apps and software]
* xref:updates-upgrades-rollbacks.adoc[OS upgrades and rollbacks]
The primary audience for these docs are new users, who aren't expected to have specialist knowledge or technical knowledge about {variant-name}'s internals.
The primary audience for these docs are new users, who aren't expected to have specialist knowledge or technical knowledge about Fedora Atomic Desktops' internals.
However, some background xref:technical-information.adoc[technical information] is provided, for those who are interested and want to learn more.

2
site.yml
View file

@ -1,6 +1,6 @@
site:
title: Local Preview
start_page: fedora-silverblue::index.adoc
start_page: fedora-atomic-desktops::index.adoc
content:
sources:
- url: .