@Tutorial {
    @Intro(title: "Set up GNOME") {
        While you can develop Adwaita apps on macOS and Windows, it is recommended to use Linux.
        Learn how to install GNOME on your device.
    }

    @Section(title: "Install GNOME on Apple silicon devices") {
        @ContentAndMedia {
            Follow this tutorial if you want to install GNOME on a recent Mac model. Note that you could also use a virtual machine instead.
        }

        @Steps {
            @Step {
                Install [Asahi Linux](https://asahilinux.org/) by running the following command in a macOS terminal: **`curl https://alx.sh | sh`**

                Follow the instructions until you get to the OS selection.
                @Image(source: "Asahi.svg", alt: "A laptop showing the Asahi logo.")
            }
            @Step {
                Make sure to select the GNOME installation option.

                Follow the instructions to complete the setup.
                @Image(source: "SelectGNOME.png", alt: "Terminal showing the OS selection.")
            }
            @Step {
                Configure GNOME. Use the settings app to change the display scaling, cursor speed, etc.

                Make sure to have at least GNOME Software, Files, and a terminal emulator installed (this should be the case).
                @Image(source: "GNOMEMacBook.png", alt: "GNOME desktop showing the Mac system information.")
            }
        }
    }

    @Section(title: "Install GNOME on other devices") {
        @ContentAndMedia {
            If you own an older Mac or another device, you have more choice.
        }

        @Steps {
            @Step {
                Select a Linux distro [on the GNOME website](https://www.gnome.org/getting-gnome/). Follow the instructions on the distro's website.

                Recommended distros providing a vanilla GNOME experience out of the box are [Vanilla OS](https://vanillaos.org/) and [Fedora Workstation](https://fedoraproject.org/en/workstation/download).
                Ubuntu is a popular distro that isn't particularly recommended as it applies its theme on your GNOME apps, and [Flatpak](https://flatpak.org/) needs additional setup.
                @Image(source: "VanillaOS.png", alt: "The Vanilla OS website.")
            }
            @Step {
                Configure GNOME using the GNOME settings app.
                Make sure to have GNOME Software, GNOME Files (Nautilus), and a terminal emulator (e.g. GNOME Console) installed.
                @Image(source: "GNOMELaptop.png", alt: "GNOME on a laptop.")
            }
        }
    }
}
