Merge pull request #140 from kbdharun/devlog-vso

feat: add VSO devlog, fix Markdown links and syntax

README.md

@@ -1,24 +1,26 @@
 <div align="center">
 <img src="logo-white.png?raw=true#gh-dark-mode-only" height="40">
 <img src="logo.png?raw=true#gh-light-mode-only" height="40">
+
 <hr />
 <p>This source code is distributed under the <a href="LICENSE">AGPL 3.0</a> 
-license, while Vanilla OS is a product of <a href="//fabricators.ltd" target="_blank">fabricators.ltd</a>. 
-Please note that all assets on this website are owned by fabricators.ltd and 
+license, while Vanilla OS is a product of <a href="//fabricators.ltd" target="_blank">fabricators.ltd</a>.
+
+Please note that all assets on this website are owned by fabricators.ltd and
 the Vanilla OS Contributors Team.</p>
 </div>
 
 ## Development
 
 ### CSS Convention
 
-Our framework follows the [BEM (Block, Element, Modifier)](https://en.bem.info/methodology/quick-start/) 
+Our framework follows the [BEM (Block, Element, Modifier)](https://en.bem.info/methodology/quick-start/)
 convention for CSS classes.
 
-Colors are defined in the `assets/css/colors/default.css` and `assets/css/colors/dark.css` 
+Colors are defined in the `assets/css/colors/default.css` and `assets/css/colors/dark.css`
 files, they must be unique and not overlap with each other.
 
-Each new component (block) must be defined in a separate file in the `assets/css/components` 
+Each new component (block) must be defined in a separate file in the `assets/css/components`
 directory and must follow the following structure:
 
 ```css

articles/2022-11-01-vanilla-installer.md

@@ -20,34 +20,35 @@ published: false
 comments: true
 ---
 
-In the past few days, we have been working on a new installer that would make 
-the first experience with Vanilla OS as pleasant as possible. The new installer 
-aims to be visually faithful to GNOME guidelines and compatible with distinst, 
+In the past few days, we have been working on a new installer that would make
+the first experience with Vanilla OS as pleasant as possible. The new installer
+aims to be visually faithful to GNOME guidelines and compatible with distinst,
 the backend used to install the system.
 
 ## The new installer
 
-The new installer is written in <mark>GTK4 and libadwaita</mark>, and it is a 
-complete replacement of the old installer ([Calamares](https://github.com/calamares/calamares)). 
-In the past few weeks, we have announced that Vanilla OS will be using the 
-[Jade](https://git.getcryst.al/crystal/software/jade-gui) installer from the 
-[Crystal Linux](https://getcryst.al/site) team, but after some testing and 
-discussions we decided to write our own to best fit it with the Vanilla OS 
+The new installer is written in <mark>GTK4 and libadwaita</mark>, and it is a
+complete replacement of the old installer ([Calamares](https://github.com/calamares/calamares)).
+In the past few weeks, we have announced that Vanilla OS will be using the
+[Jade](https://git.getcryst.al/crystal/software/jade-gui) installer from the
+[Crystal Linux](https://getcryst.al/site) team, but after some testing and
+discussions we decided to write our own to best fit it with the Vanilla OS
 experience.
 
 The [Vanilla Installer](https://github.com/Vanilla-OS/vanilla-installer) is
-built on top of the [Vanilla First Setup](https://github.com/Vanilla-OS/first-setup) 
-project, the utility that is used to configure the system after the installation. 
+built on top of the [Vanilla First Setup](https://github.com/Vanilla-OS/first-setup)
+project, the utility that is used to configure the system after the installation.
 Both projects are written in **Python** and are meant to be flexible and easy to
 maintain.
 
 ## The new installer in action
 
 We are currently testing the new installer and **will release it with the next
-open beta**. It is however possible to test it in the current images by following 
+open beta**. It is however possible to test it in the current images by following
 the instructions at the end of the article.
 
 The installation process is divided into seven steps:
+
 - Welcome
 - Language
 - Keyboard
@@ -62,14 +63,14 @@ it, while the installation mode is used to install the system on the device.
 
 ![Welcome - Vanilla Installer](/uploads/installer-welcome.png)
 
-Once the user has chosen the installation mode, the **Language** screen is shown. 
+Once the user has chosen the installation mode, the **Language** screen is shown.
 In this screen, it is possible to choose the language in which Vanilla OS will be
 installed. Here a search bar is available to quickly find the language.
 
 ![Language - Vanilla Installer](/uploads/installer-language.png)
 
-The **Keyboard** screen allows the user to choose the keyboard layout that will 
-be used in the system. As for the language, a search bar is available to 
+The **Keyboard** screen allows the user to choose the keyboard layout that will
+be used in the system. As for the language, a search bar is available to
 quickly find the keyboard layout, plus a test area to test the keyboard layout.
 
 ![Keyboard - Vanilla Installer](/uploads/installer-keyboard.png)
@@ -89,6 +90,7 @@ The **Partitioning** screen allows the user to choose where to install the syste
 Once a disk is selected, it is possible to choose between automatic or manual
 partitioning. In automatic partitioning, the disk is automatically partitioned
 with the following layout:
+
 - 512 MB EFI partition
 - 512 MB swap partition
 - 1024 MB boot partition
@@ -125,6 +127,7 @@ logs.
 
 The new installer is not yet available in the open beta images, but it is
 possible to test it in the current images by following these steps:
+
 - Download the latest image
 - Boot the image
 - Open a terminal
@@ -147,14 +150,14 @@ apx --sys remove calamares
 
 We would like to thank all the people that joined the development of the new
 installer (design, development and testing), especially:
+
 - [Muqtxdir](https://github.com/Muqtxdir) (development and design)
 - [kra-mo](https://github.com/kra-mo) (illustrations)
-See [here](https://github.com/Vanilla-OS/vanilla-installer/graphs/contributors) 
+See [here](https://github.com/Vanilla-OS/vanilla-installer/graphs/contributors)
 for the full list of contributors.
 
-Also, we would like to thank the Crystal Linux team (mainly [axtloss](https://github.com/axtloss)) 
-for their work on the Jade installer, which was a great inspiration for the 
+Also, we would like to thank the Crystal Linux team (mainly [axtloss](https://github.com/axtloss))
+for their work on the Jade installer, which was a great inspiration for the
 new installer.
 
-
 _ The Vanilla Team

articles/2022-12-18-end-of-winter-wallpaper-competition-2022.md

@@ -20,40 +20,40 @@ We received more submissions, but only 3 of them met the requirements. Here they
 
 ### 1. by 4e6anenk0
 
-| ![A snowy taiga with a shooting star-like Vanilla OS logo in place of the star in daylight.](/uploads/WWC2022/4e6anenk0-light.png) | 
-|:--:| 
+| ![A snowy taiga with a shooting star-like Vanilla OS logo in place of the star in daylight.](/uploads/WWC2022/4e6anenk0-light.png) |
+|:--:|
 | *Light variant* |
 
-| ![A melting snowy taiga with a shooting star-like Vanilla OS logo in place of the star at night.](/uploads/WWC2022/4e6anenk0-dark.png) | 
-|:--:| 
+| ![A melting snowy taiga with a shooting star-like Vanilla OS logo in place of the star at night.](/uploads/WWC2022/4e6anenk0-dark.png) |
+|:--:|
 | *Dark variant* |
 
 ### 2. by conquodS
 
-| ![A snowy taiga with dead trees spanning the view in daylight.](/uploads/WWC2022/conquodS-light.png) | 
-|:--:| 
+| ![A snowy taiga with dead trees spanning the view in daylight.](/uploads/WWC2022/conquodS-light.png) |
+|:--:|
 | *Light variant* |
 
-| ![A snowy taiga with dead trees spanning the view at night.](/uploads/WWC2022/conquodS-dark.png) | 
-|:--:| 
+| ![A snowy taiga with dead trees spanning the view at night.](/uploads/WWC2022/conquodS-dark.png) |
+|:--:|
 | *Dark variant* |
 
 ### 3. by kramo
 
-| ![A frozen lake in a taiga in daylight.](/uploads/WWC2022/kramo-light.png) | 
-|:--:| 
+| ![A frozen lake in a taiga in daylight.](/uploads/WWC2022/kramo-light.png) |
+|:--:|
 | *Light variant* |
 
-| ![A frozen lake in a taiga at night.](/uploads/WWC2022/kramo-dark.png) | 
-|:--:| 
+| ![A frozen lake in a taiga at night.](/uploads/WWC2022/kramo-dark.png) |
+|:--:|
 | *Dark variant* |
 
 ## How to vote
 
-You can vote for your favourite wallpaper by dropping an emoji reaction on the Discord message linked below. 
+You can vote for your favourite wallpaper by dropping an emoji reaction on the Discord message linked below.
 
 [**Vote for your favourite wallpaper here!**](https://discord.com/channels/1023243680829681704/1054161350374465627/1054161350374465627)
 
 You can vote for as many wallpapers as you want, with only one vote per wallpaper. The voting will end on the 21st of December 2022 at 23:59 UTC.
 
-*- The Vanilla Team*
+_ The Vanilla Team

articles/2022-12-29-vanilla-os-22-10-kinetic.md

@@ -18,63 +18,63 @@ published: true
 comments: true
 ---
 
-It is with great pleasure that we announce that Vanilla OS 22.10 Kinetic, the 
+It is with great pleasure that we announce that Vanilla OS 22.10 Kinetic, the
 first stable release of the project, is available for download!
 
-We have been working on the project for many months, there were many changes 
+We have been working on the project for many months, there were many changes
 along the way and also many complications, but we managed to get through them.
 
-Introducing such a large project is not easy, there are many ways, many means 
+Introducing such a large project is not easy, there are many ways, many means
 and so many things to say. To make it easier for you to understand this project,
-we created a commercial like the big guys do (or at least we tried). Here it 
+we created a commercial like the big guys do (or at least we tried). Here it
 is below, enjoy it but then come back here, we have a lot to talk about!
 
 <div class="video">
     <iframe src="https://www.youtube.com/embed/aDvIJ_Hu90Y?controls=0" allowfullscreen="" frameborder="0" height="315" width="560"> </iframe>
 </div>
 
-Vanilla OS is not an ordinary Linux distribution, it is a project that sets 
-itself many goals and is not afraid to put itself out there, proudly displaying 
-its unique technologies such as the Apx sub-system, its own automatic update 
+Vanilla OS is not an ordinary Linux distribution, it is a project that sets
+itself many goals and is not afraid to put itself out there, proudly displaying
+its unique technologies such as the Apx sub-system, its own automatic update
 system, and ABRoot transactions.
 
-![](/uploads/vanilla-os-stable-illustration.webp)
+![Image showing the sun rising with a Vanilla flower in between](/uploads/vanilla-os-stable-illustration.webp)
 
-So many terms, so many promises, so much everything. But let's see together, in 
+So many terms, so many promises, so much everything. But let's see together, in
 detail what the strengths of Vanilla OS are, the features that make it unique.
 
 ## Apx
 
-Vanilla OS comes with its own sub-system.. ehm.. package manager, called Apx 
+Vanilla OS comes with its own sub-system.. ehm.. package manager, called Apx
 (`/à·peks/`).
 
-Apx introduces a whole new paradigm in package management. The idea is to use 
-your system only as a box for storing your files, leaving it clean of packages 
-and limiting the risk of breaking due to incompatible, poorly constructed or 
+Apx introduces a whole new paradigm in package management. The idea is to use
+your system only as a box for storing your files, leaving it clean of packages
+and limiting the risk of breaking due to incompatible, poorly constructed or
 conflicting packages.
 
 It achieves this by installing software inside one or more containers fully
 managed by Apx having restricted access to your system’s resources while still
 being able to use the same drivers, hardware, etc.
 
-By default, Apx provides a container based on your Linux distribution (Ubuntu 
-22.10 for Vanilla OS 22.10) and wraps all commands from the distribution’s 
+By default, Apx provides a container based on your Linux distribution (Ubuntu
+22.10 for Vanilla OS 22.10) and wraps all commands from the distribution’s
 package manager (apt for Ubuntu).
 
 ![The "apx enter" command entering an Ubuntu 22.10 container, with the output of "cat /etc/os-release".](/uploads/vanilla-os-apx.png)
 
-Nevertheless, you can install packages from other package distributions. For 
-example, using the `--aur` flag, a new container based on Arch Linux will be 
-created. Here, apx will manage the packages from the AUR (Pacman and yay), 
-tightly integrating them with the host system. Using the `--dnf` flag with apx 
-will create a new container based on Fedora Linux. Here, apx will manage 
-packages from Fedora’s DNF repository, tightly integrating them with the host 
+Nevertheless, you can install packages from other package distributions. For
+example, using the `--aur` flag, a new container based on Arch Linux will be
+created. Here, apx will manage the packages from the AUR (Pacman and yay),
+tightly integrating them with the host system. Using the `--dnf` flag with apx
+will create a new container based on Fedora Linux. Here, apx will manage
+packages from Fedora’s DNF repository, tightly integrating them with the host
 system.
 
 ![Vanilla Control Center showing the list of installed applications in a "Sub System" tab, "htop". There are also "Drivers" and "Updates" tabs.](/uploads/vanilla-os-apx-control-center.png)
 
-Graphical applications installed inside apx containers are automatically added 
-to the Applications menu as well as the “Open with” menu in the file manager. 
+Graphical applications installed inside apx containers are automatically added
+to the Applications menu as well as the “Open with” menu in the file manager.
 They are also listed in the Sub System section of Vanilla control center.
 
 ## ABRoot
@@ -97,48 +97,48 @@ normally, without any changes to either partition.
 
 ## ~~Automatic~~ Smart Updates
 
-Vanilla OS comes with a new concept of automatic updating, an intelligent 
-system let's say. VSO (Vanilla System Operator) is the tool that will 
-periodically check for an update and then download and install it in the 
-background if the device is not under heavy usage. In fact, VSO checks that 
-certain checks are met, such as whether the resources are free (CPU/RAM), 
+Vanilla OS comes with a new concept of automatic updating, an intelligent
+system let's say. VSO (Vanilla System Operator) is the tool that will
+periodically check for an update and then download and install it in the
+background if the device is not under heavy usage. In fact, VSO checks that
+certain checks are met, such as whether the resources are free (CPU/RAM),
 whether the connection allows it, whether the battery is at least 30%, etc.
 
-We designed this system to take away an annoying task from the user, who 
-simply wants to do their own thing. Updates go through ABRoot transactions and 
+We designed this system to take away an annoying task from the user, who
+simply wants to do their own thing. Updates go through ABRoot transactions and
 are applied on the next reboot, without taking extra time during boot.
 
 ![The Updates tab of the Vanilla Control Center showing the latest update check, weekly updates scheduling set, and "SmartUpdate," where the system will not update if the system is under load or the battery is low.](/uploads/vanilla-os-updates.png)
 
-From the Vanilla Control Center, it is possible to set the update frequency, 
+From the Vanilla Control Center, it is possible to set the update frequency,
 check when the last one was performed, and turn off Smart Update features.
 
 ## First Setup
 
-Unlike other Linux distributions, Vanilla OS is designed to provide a user 
+Unlike other Linux distributions, Vanilla OS is designed to provide a user
 experience built for you, just like a suit!
 
-After the first boot, you will be prompted to complete the installation through 
-a guided process. Here you will be able to make several choices, such as for 
+After the first boot, you will be prompted to complete the installation through
+a guided process. Here you will be able to make several choices, such as for
 Dark Mode, Flatpak, AppImage, NVIDIA drivers, and more.
 
 ![The first boot prompt for Vanilla OS with a button to confirm beginning setup.](/uploads/vanilla-os-first-setup.png)
 
-The process is designed to be fast and as minimally invasive as possible. Once 
+The process is designed to be fast and as minimally invasive as possible. Once
 complete, you will need to reboot to be able to use your device with Vanilla OS!
 
 ## GNOME 43
 
-Vanilla OS uses GNOME 43 as its Desktop Environment. It is a stock, clean 
-version with as few changes as possible to give you the best GNOME experience 
+Vanilla OS uses GNOME 43 as its Desktop Environment. It is a stock, clean
+version with as few changes as possible to give you the best GNOME experience
 ever.
 
-We chose to provide GNOME because of its uniqueness and ease of use, which make 
+We chose to provide GNOME because of its uniqueness and ease of use, which make
 it the perfect companion to Vanilla OS.
 
 ![GNOME 43 with the default Vanilla OS wallpaper.](/uploads/vanilla-os-gnome.png)
 
-All official Vanilla OS applications are built with GTK4 and Libadwaita to be 
+All official Vanilla OS applications are built with GTK4 and Libadwaita to be
 as consistent as possible with the GNOME experience.
 
 ## Official Wallpapers

articles/2023-01-28-almost-vs-abroot.md

@@ -77,7 +77,7 @@ In conclusion, we've developed both Almost and ABRoot to achieve immutability in
 
 ## Useful links
 
-- [ABRoot documentation](https://documentation.vanillaos.org/docs/ABRoot/)
+- [ABRoot documentation](https://documentation.vanillaos.org/en/abroot)
 - [ABRoot source code](https://github.com/Vanilla-OS/ABRoot/)
-- [Almost documentation](https://documentation.vanillaos.org/docs/almost/)
+- [Almost documentation](https://documentation.vanillaos.org/en/almost)
 - [Almost source code](https://github.com/Vanilla-OS/almost)