Replaced template with asciidoc version of beginner's guide

antora.yml

@@ -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: pizza-factory  # <---- PLEASE MODIFY
+name: beginners-guide  # <---- PLEASE MODIFY
 
 # Title will be visible on the page.
-title: Pizza Factory # <---- PLEASE MODIFY
+title: A Beginner's Guide to Fedora # <---- PLEASE MODIFY
 
 # 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.

modules/ROOT/examples/exampe-example.adoc

@@ -1,9 +0,0 @@
-This is an example of a example file. Unlike files in `pages/`, files in this directory are not built as standalone pages, but only if they are included in a file within `pages/`. Also unlike examples,
-A file in this directory can be included within any file in the `pages/` directory.
-
-Most common use cases for examples is using output from an external script (for example, translation string statistics) in docs. You can use an external script to update the example, and when the site is rebuilt, it will show updated output.
-
-If you want to include this particular example somewhere, you can use the following syntax: `include::example$example-example.adoc[]`.
-Note the use of `example$` instead of an actual file location.
-
-See link:https://docs.antora.org/antora/3.0/examples-directory/[Antora docs on examples] for more information about partials.

modules/ROOT/nav.adoc

@@ -1,5 +1,50 @@
-* xref:architecture.adoc[Architecture]
-** xref:pizza-oven.adoc[Pizza Oven]
-** xref:pizza-dough.adoc[Pizza Dough]
-* xref:community.adoc[Community]
-* xref:faq.adoc[FAQ]
+* xref:index.adoc[Introduction]
+** xref:index.adoc#_what_is_the_fedora_project[What is The Fedora Project?]
+** xref:index.adoc#_what_is_fedora_linux[What is Fedora Linux?]
+* xref:try_fedora.adoc[Let's Try Fedora!]
+** xref:try_fedora.adoc#_downloading_making_a_bootable_usb_drive[Downloading & making a bootable USB drive]
+** xref:try_fedora.adoc#_trying_out_fedora_kde_live[Trying Out Fedora KDE Live]
+* xref:install_fedora.adoc[Installing Fedora KDE Permanently]
+** xref:install_fedora.adoc#_step_one_back_up_all_your_information_from_your_existing_operating_system[Step One: BACK UP ALL YOUR INFORMATION FROM YOUR EXISTING OPERATING SYSTEM]
+** xref:install_fedora.adoc#_step_two_check_your_backups[Step Two: Check your backups]
+** xref:install_fedora.adoc#_step_three_install_fedora_from_the_live_environment[Step Three: Install Fedora from the Live environment]
+*** xref:install_fedora.adoc#_setting_time_and_date[Setting Time and Date]
+*** xref:install_fedora.adoc#_install_destination[Install Destination]
+*** xref:install_fedora.adoc#_encryption_yes_or_no[Encryption - yes or no?]
+*** xref:install_fedora.adoc#_user_account_and_password[User Account and Password]
+*** xref:install_fedora.adoc#_go_for_it[Go For It!
+]
+** xref:install_fedora.adoc#_step_four_set_up_internet_install_updates[Step Four: Set up Internet & Install Updates]
+* xref:daily_driver.adoc[Fedora as your daily driver]
+** xref:daily_driver.adoc#_find_your_way_around_kde_plasma[Find Your Way Around KDE Plasma]
+** xref:daily_driver.adoc#_accessibility[Accessibility]
+** xref:daily_driver.adoc#_finding_new_software[Finding new software]
+** xref:daily_driver.adoc#_setting_up_email_with_thunderbird[Setting up email with Thunderbird]
+** xref:daily_driver.adoc#_browsing_the_web[Browsing the web]
+** xref:daily_driver.adoc#_using_libreoffice[Using LibreOffice]
+** xref:daily_driver.adoc#_setting_up_a_printer[Setting up a printer]
+** xref:daily_driver.adoc#_using_a_scanner[Using a scanner]
+** xref:daily_driver.adoc#_setting_up_syncnshare[Setting up sync’n’share]
+** xref:daily_driver.adoc#_gaming_on_linux[Gaming on Linux]
+** xref:daily_driver.adoc#_audio[Audio]
+** xref:daily_driver.adoc#_video[Video]
+** xref:daily_driver.adoc#_graphic_software[Graphic Software]
+** xref:daily_driver.adoc#_making_backups[Making Backups]
+** xref:daily_driver.adoc#_nvidia_and_linux[Nvidia and Linux]
+** xref:daily_driver.adoc#_managing_fedora[Managing Fedora]
+** xref:daily_driver.adoc#_getting_help_with_fedora[Getting Help with Fedora]
+* xref:advanced_kde.adoc[Advanced KDE Use -- "Release the Kraken!"]
+** xref:advanced_kde.adoc#_virtual_desktops[Virtual Desktops]
+** xref:advanced_kde.adoc#_keyboard_shortcuts[Keyboard Shortcuts]
+** xref:advanced_kde.adoc#_quick_app_launching[Quick App Launching]
+** xref:advanced_kde.adoc#_screen_edges[Screen Edges]
+** xref:advanced_kde.adoc#_user_accounts_sharing_your_computer[User Accounts: Sharing Your Computer]
+* xref:cli.adoc[Advanced Command Line Use -- "In the Beginning there was Shell"]
+** xref:cli.adoc#_the_linux_filesystem[The Linux Filesystem]
+** xref:cli.adoc#_the_terminal_emulator_shell[The Terminal Emulator & Shell]
+** xref:cli.adoc#_what_is_sudo[What is sudo?
+]
+** xref:cli.adoc#_command_line_package_management[Command line package management]
+** xref:cli.adoc#_viewing_processes_on_the_shell[Viewing processes on the shell]
+** xref:cli.adoc#_how_to_manage_processes[How to manage processes]
+* xref:credits.adoc[Credits]

modules/ROOT/pages/advanced_kde.adoc

@@ -0,0 +1,124 @@
+== Advanced KDE Use -- "Release the Kraken!"
+
+=== Virtual Desktops
+
+_Virtual Desktops_ help you organize your screen workspace by adding additional, virtual screen spaces to the left, top, bottom or right of your screen.
+You can place application windows on different Virtual Desktops and switch between them either using a widget in the menu bar or keyboard shortcuts.
+
+To add Virtual Desktops, open System Settings, navigate to "Window Management" \-> "Virtual Desktops" and click "+ Add Desktop" to add additional Virtual Desktops.
+
+image::Virtual_Desktops.png[Virtual Desktops]
+
+This will add all desktops in a single row. To add more rows, simply select your desired number of rows in "Rows".
+
+Your added desktops will show up in the menu bar widget after clicking "Apply".
+
+image::Virtual_Desktops_Widget.png[Virtual Desktops Widget]
+
+Switch between them by clicking on the widget or by using the following keyboard shortcuts:
+
+* _Meta-Ctrl-Left_: move left
+* _Meta-Ctrl-Right_: move right
+* _Meta-Ctrl-Up_: move up
+* _Meta-Ctrl-Down_: move down
+
+(Note: Meta usually is the key with the window symbol on your keyboard.)
+
+When using the application switcher (see below!), switching to apps on different Virtual Desktops will automatically switch between desktops, too.
+
+=== Keyboard Shortcuts
+
+To see all possible keyboard shortcuts or to define your own, open _System Settings_ and go to "Keyboard" > "Shortcuts".
+
+==== System Settings
+
+Sometimes you need to quickly open System Settings to change a setting. _Meta-I_ will open System Settings at any time.
+
+==== Managing Apps
+
+If you're like us, you regularly have many apps open.  Putting them on virtual desktops helps unclutter your screen. To switch between application windows:
+
+* _Alt-Tab_: opens the application switcher; press to cycle through your open apps
+* _Ctrl-F10_: zoom out of all desktops and show all application windows next to each other
+* _Alt-F4_: close an app
+* _Meta-Ctrl-Shift-Arrowkey_: move the current app window on a virtual desktop up, down, left or right
+* _Meta-PageDown_: minimize a window
+* _Meta-PageUp_: maximize a window
+
+==== Konsole
+
+As a Linux power user you'll regularly need a shell in Konsole. To quickly fire up Konsole, simply press _Ctrl-Alt-T_. You can read more about this in 'Advanced Command Line Use -- "In the Beginning there was Shell"'.
+
+==== System Monitor
+
+If your system feels slow and you suspect that an app is eating your CPU or RAM, pressing _Meta-ESC_ will open the System Monitor which lets you inspect all aspects of your system:
+
+* CPU & GPU
+* processes
+* performance history
+
+You can stop / kill processes from System Monitor.
+
+=== Quick App Launching
+
+Imagine you're working on something using your keyboard and quickly need to launch Firefox to look something up. Instead of using the mouse or touchpad, there are two ways to do this with your keyboard.
+
+Pressing _Alt-Space_ will open KRunner at the top of your screen.
+
+image::KRunner.png[KRunner]
+
+Start typing the name of the app you want. KRunner will highlight the best match. Pressing _Enter_ will launch the app. If your app is further down in the list, navigate to it using the arrow keys and launch it with _Enter_ as well. The search is fuzzy so you'll find apps even if you don't exactly know the name.
+
+The second way is the Application Launcher's search. Simply press _Meta_ to open the Application Launcher but instead of clicking through menus, simply start typing the app's name. Similarly to KRunner, Application Launcher will highlight the best match and you launch the app by pressing _Enter_.
+
+image::Application_Launcher_Search.png[Application Launcher Search]
+
+=== Screen Edges
+
+KDE has a feature called "Screen Edges". Moving your mouse to the four edges or the four corners of your screen triggers a command that you can define. To configure, open System Settings and go to "Display & Monitor" > "Screen Edges".
+
+image::Screen_Edges.png[Screen Edges]
+
+The settings menu shows a monitor with edges and corners. Click one of the squares on the monitor and a drop-down list lets you select the action you want to trigger. You could, for example, have the lower left-hand corner trigger the lock screen.
+Explore the other triggers. They offer a helpful way to manage your desktop with a mouse.
+
+=== User Accounts: Sharing Your Computer
+
+Fedora is a multi-user system by design.
+This means:
+
+* You can have multiple users on the same system
+* Each user has their own
+ ** home directory
+ ** settings
+ ** desktop layout
+ ** configuration
+
+At least one user on your computer (that is *you* if you installed Fedora on it) is the administrator of the system.
+The administrator has special privileges including installing software, changing ownership of files and accessing every aspect of the system.
+Non-admin users have limited rights. They can't accidentally damage vital parts of the system.
+
+The admin of the computer can create other user accounts - to do so:
+
+* Open System Settings
+* Scroll to "Users"
+* Click on "+ Add new..." to add an additional user
+* Enter the user information in the "Create User" dialogue
+
+image::Create_User.png[Create User]
+
+IMPORTANT: Have as few "Administrator" users as possible.
+Typically, users should have the "Standard" account type with limited privileges.
+*Remember:* administrators have full access to _all_ system settings and accounts, _including your account_.
+*With great power comes great responsibility!*
+
+==== Logging in as a different user
+
+The username and the password you assigned to users in the previous step are their _credentials_. Users log in to Fedora by entering their credentials on the login screen. The login screen appears...
+
+* directly after booting
+* or after a user has logged out
+* or after a user selected "Switch User" from the "Session" menu in the Application Launcher
+* or while the screen is locked
+
+Note that multiple users can stay logged in _simultaneously_, albeit only one user can have their Desktop Environment open at the same time. You can switch users at any time and this will resume with the user's DE exactly how they left it unless the computer is rebooted. Logging in as a second user or even more *will not terminate* other user sessions.

modules/ROOT/pages/architecture.adoc

@@ -1,3 +0,0 @@
-= Pizza Factory Architecture
-
-The architecture of our pizza factory is quite simple. We bake our very expensive xref:pizza-dough.adoc[pizza dough] in a very cheap xref:pizza-oven.adoc[pizza oven]. This way, we can achieve a mediocre result for a high price and a reasonable number of failures.

modules/ROOT/pages/cli.adoc

@@ -0,0 +1,230 @@
+== Advanced Command Line Use -- "In the Beginning there was Shell"
+
+=== The Linux Filesystem
+
+A big part of understanding Linux is to know your way around the filesystem.
+
+Linux is configured using files stored in certain directories (`/etc`), program binaries are located in directories (`/usr/bin` etc.) and even access to devices like hard drives, networks adapters etc. are provided by file-like objects in a directory (`/dev`). Linux has this in common with most UNIX-like operating systems.
+
+The following list gives you an overview of directories you'll most likely be using:
+
+* `/home`: as the name suggest, this is where your users files and configuration reside.
+The data that you store here is in a subdirectory that normally has the same name as your login, such as /home/myuser
+* Each user has their own subdirectory in `/home`. The permissions of these home directories on Fedora is set in a way that no user can look at the data of any other user (except for users with administrator rights who have access to *all directories*).
+* `/etc`: your global system configuration is stored here. We're talking about network configuration, how hard drives are "mounted" into the filesystem, the name of your computer and more.
+
+While Fedora KDE Plasma helps you configure your computer using the graphical user interface of System Settings, you can choose to edit configuration in `/etc` manually using a text editor.
+
+To learn more about the Linux filesystem, have a look at the https://refspecs.linuxfoundation.org/FHS_3.0/fhs/index.html[Filesystem Hierarchy Standard] by the https://www.linuxfoundation.org/[Linux Foundation]. It lists system directories found on your computer and explains their purpose.
+
+=== The Terminal Emulator & Shell
+
+Parallel to the graphical interface of desktop environments lives the command line. To properly display and use the command line in a desktop environment, two components are needed:
+
+* _Terminal Emulator_: a program that lets you interact with the...
+* _Shell_: the command processor for the command line.
+
+The terminal emulator deals with your keyboard input to the shell and also the output that the shell generates by properly displaying it in a program window.
+
+By using the _shell_, you unlock the full range and power of Linux commands.
+
+Shell commands can:
+
+* browse the filesystem
+* copy, move and delete files
+* edit files
+* configure your computer
+* display information
+* install and remove software
+* connect to other computers
+
+To use the shell, open the Application Launcher, navigate to "System" and click on "Konsole". Konsole is the standard _terminal emulator_ that comes with KDE Plasma.
+
+The command to learn commands is `man`.
+It lets you display manpages -- manual pages -- of most available commands. To open the manpage of the `ls` command, you would call
+
+[,shell]
+----
+> man ls
+----
+
+Go ahead and run it, and learn what `ls` does - or at least learn the options that you call with `ls`.
+
+You can scroll the manpage with the mouse-wheel, arrow or page up / down keys. To exit the manpage viewer, press "q".
+
+The default shell on Fedora is https://www.gnu.org/software/bash/[Bash]. However, there are many other shells, too.
+
+Here's a list of commands we encourage you to explore which help you move around the filesystem of your computer:
+
+* `ls`
+* `cd`
+* `cp`
+* `mv`
+* `rm` (careful!)
+* `cat`
+* `less`
+
+IMPORTANT: Read the manpage of each command before using it!
+
+There are two main editors that most people use:
+
+* https://nano-editor.org/[nano^]
+* https://www.vim.org/[vim^]
+
+Both editors' homepages have documentations sections and we suggest you familiarize yourself with one of these editors to be able to edit files in the terminal.
+
+CAUTION: The shell IS powerful. You have complete control over your system.  This includes the power to delete your files or break your system.
+
+But don't be afraid, be aware.
+
+Understand what a command does before using it. Don't copy and paste instructions from the internet or AIs without knowing what they will do.
+Being able to work in the terminal is essential to tackle advanced workflows.
+
+If you'ld like to test shell commands but don't feel safe, grab the USB drive you used to install Fedora, boot the live system and explore or visit https://webminal.org/[^]
+You won't damage your installation as long as you don't `mount` your hard drive.
+Run `man mount` if you want to know what we're talking about :)
+
+=== What is sudo?
+
+sudo stands for "substitute user and do". Annecdotally, it also stands for "superuser do".
+
+Calling any command prefixed with `sudo` will be run as the superuser, also known as the 'root' account. Only Administrators can run `sudo`.
+This keeps normal users from running commands that could break the system.
+
+Commands that can permanently change the system usually require 'sudo'.  If you run a command, and the shell tells you "this command must be run as root", you need to prefix it with 'sudo' to actually use it. Before you do, think about what you are doing.
+
+Be aware when copying and pasting commands from the internet or AI that are prefixed with "sudo".  It is possible to add malicious code to you Linux system. Don't paste code you don't understand.
+
+Refer to `man sudo` to learn more.
+
+=== Command line package management
+
+To show you how to install new software via the command line, we will give the same instructions as we did for installing the same games as we did in the Gaming section above - but this time, we won't use Discover, we will use the command line in Konsole.
+
+Since installing packages is a system operation that can only be executed by administrators, you will be using `sudo`.
+
+==== Intro to dnf
+
+dnf stands for "dandified yum".  Don't ask why :) +
+yum is the older package manager for another Linux distribution, Red Hat.
+
+A package manager is software that installs, manages, updates and removes software.
+
+Essential dnf commands are:
+
+* install
+* update
+* remove
+
+If you would like a deep-dive into dnf, https://dnf5.readthedocs.io/en/latest/commands/index.html is quite advanced.
+
+==== Installing Software via Command Line
+
+[,shell]
+----
+> sudo dnf install <nameofsoftware>
+----
+
+e.g. to install
+
+[,shell]
+----
+> sudo dnf install xeyes
+----
+
+and to removee.g.
+
+[,shell]
+----
+> sudo dnf remove xeyes
+----
+
+==== Installing Games with the Command Line
+
+Supertuxkart
+
+[,shell]
+----
+> sudo dnf install supertuxkart
+----
+
+Oad
+
+[,shell]
+----
+> sudo dnf install 0ad
+----
+
+Luanti
+
+[,shell]
+----
+> sudo dnf install luanti
+----
+
+Xonotic
+
+[,shell]
+----
+> sudo dnf install xonotic
+----
+
+==== Updating Fedora via Command Line
+
+[,shell]
+----
+> sudo dnf update
+----
+
+=== Viewing processes on the shell
+
+Each running program or script on Linux is called a _process_.
+A process has a number of properties, among others:
+
+* a process ID, the _PID_
+* an owner
+
+When the system boots, the first process that is spawned is "systemd". Hence it has the PID "1".
+All processes are spawned by a parent process.
+You will notice later that most system processes that help running your computer have "1" (systemd) as their parent process.
+One of systemd's jobs is to start all processes necessary to have a working computer.
+
+To see what processes are running, issue the `ps` command in the shell after reading its manpage. A very common way to call `ps` is
+
+[,shell]
+----
+> ps -elf
+----
+
+which will display detailed process information.
+
+Another useful command to see processes with their respective statistics is `top`. It will show you CPU and memory usage as well as PIDs and process names and owners.
+A more modern version of `top` is `btop` which needs to be installed by typing
+
+[,shell]
+----
+> sudo dnf install btop
+----
+
+Run `btop` in Konsole and explore the information it gives you.
+
+=== How to manage processes
+
+Linux has its faults, so do programs. It can happen that programs crash and need to be terminated. You can do it by
+
+* finding the PID using `ps` or `top`
+* issuing the `kill` command
+
+Despite its name, `kill` is not meant to only kill a process. It sends a so called _signal_  to a process. Let's say the program that doesn't respond anymore has the PID "123". You would first try to send it the _SIGHUP_ signal to terminate it:
+
+[,shell]
+----
+> kill -1 123
+----
+
+Note that "-1" is synonymous for "-SIGHUP". Check again using `ps` -- if the process is still running, it's time for the sledgehammer: _SIGKILL_:
+
+[,shell]
+----
+> kill -9 123
+----

modules/ROOT/pages/community.adoc

@@ -1,3 +0,0 @@
-= Pizza Factory Community
-
-Our community is basically the same as the community of Fedora Docs. That's mostly because this is a template for new pieces of the Fedora Docs.

modules/ROOT/pages/credits.adoc

@@ -0,0 +1,5 @@
+== Credits
+
+Thank you for reading :)  The authors legitimately love Linux both as something fun to do on a Friday night and as a useful tool.  We hope Linux can serve you too, and that one day you will contribute to or promote Open Source software.
+
+The authors are Fedora contributors Christian Strauf https://forge.fedoraproject.org/cstrauf[@cstrauf] and Mat Holmes https://forge.fedoraproject.org/theprogram[@theprogram].

modules/ROOT/pages/daily_driver.adoc

@@ -0,0 +1,326 @@
+include::partial$attributes.adoc[]
+
+== Fedora as your daily driver
+
+=== Find Your Way Around KDE Plasma
+
+image::Desktop.png[Desktop]
+
+Welcome to your brand-new Fedora KDE Plasma desktop!
+
+KDE feels similar to other operating systems you already know.
+You'll very quickly learn how to navigate your new desktop.
+
+To give you a quick overview, here are the most important features:
+
+*(1) Application Launcher:*
+The Fedora symbol will open a menu from which you can easily start your applications by clicking on their icons.
+You can also use the "Search..." field to search for the name of the application you want to launch.
+The Application Launcher is also the place where to shutdown or restart your computer.
+You can also lock your screen, log out or even change users on-the-fly if you share your computer with other persons (more on that later).
+
+*(2) Discover:*
+Use it to explore, install and update your applications. Please refer to the https://docs.fedoraproject.org/en-US/kde/appinstallation/[Fedora Discover documentation page^] for more information on how to manage your apps.
+
+*(3) Dolphin file browser:*
+You can explore the filesystem of your computer and also network filesystems on your local network.
+Any attached USB drives will automatically show up in Dolphin. Click on the USB name to activate or "mount" the USB before accessing the files.
+Remember to click the "eject" symbol before removing the USB drive. Ejecting the drive is essential on Linux.
+
+*(4) System Tray:*
+Contains information about notifications, clipboard content, audio volume and devices, network connections etc.. Next to it you will find the current time and date.
+You should regularly update all installed packages.
+When this symbol shows up in your System Tray, new updates are available:
+
+image::Updates_available.png[Updates available]
+
+Clicking it will open a Discover update window from which you can start the update of all packages.
+Discover will ask you to restart the system to install updates. Do this.
+We recommend you use this method until you want to learn to use the command line.
+
+*(5) System Settings:*
+This is the configuration hub of your computer. It lets you adjust your system. System settings are arranged thematically.
+Take your time to explore your settings and make use of the "Help" button to familiarize yourself with the options you have for each setting.
+If you accidentally make a change that you don't know how to undo, clicking the "Defaults" button will restore a usable setting. If you don't know where to look for a certain setting, KDE Plasma has you covered: simply enter what you're looking for in the "Search..." field on top and System Settings will point you to the right section.
+
+Explore your new OS.
+
+NOTE: Don't be afraid. "Dangerous" operations will require you to enter your password to authorize them so it's quite difficult to accidentally damage your system.
+
+=== Accessibility
+
+Fedora KDE Plasma comes with accessibility features.  You can access them by opening "System Settings" and then the "Accessibility" menu.
+
+image::Accessability.png[Accessibility]
+
+KDE Plasma features include:
+
+* a screen reader
+* magnification tools
+* color correction for people with color blindness
+
+Please note that some applications like LibreOffice have their own or additional accessibility features. Take a look at their documentation for more information.
+
+KDE Plasma has accessibility features, yet we know they may be incomplete.
+We advise you to thoroughly test the Fedora KDE Plasma Live environment before installing to determine whether the available features meet your requirements.
+
+=== Finding new software
+
+Discover is a graphical way to download and install and update software.
+
+Fedora has several _Software Repositories_ (_Repos_) which Discover will download from.
+This guide will deal with Fedora's main repo to install software from.
+
+All software showing the *"From Fedora Linux"* tag in the upper right corner of their descriptive page in Discover comes from Fedora's main repo:
+
+image::From_Fedora_Linux.png[From Fedora Linux]
+
+All software in Fedora's main repo is Open Source and free! You can install and use the software for home and business use.
+
+=== Setting up email with Thunderbird
+
+You can install Mozilla Thunderbird from Discover. It is an established and popular email client. We recommend reading https://support.mozilla.org/en-US/kb/getting-started-thunderbird[Mozillas "Get started with Thunderbird" guide^] how to set up Thunderbird.
+
+If you've exported your mail and settings from  Thunderbird on your old OS, you can https://support.mozilla.org/en-US/kb/thunderbird-import[import them in Thunderbird^] on Fedora.
+
+=== Browsing the web
+
+Fedora KDE Plasma comes with Firefox browser pre-installed.
+Your Firefox experience is the same on Fedora Linux as it is on your previous OS.
+Users of other browsers should be able to adapt to Firefox as it shares most features with other major browsers.
+
+If you used Firefox in your old OS and made an export, you can keep your configuration.
+
+Follow https://support.mozilla.org/en-US/kb/back-and-restore-information-firefox-profiles[this guide^] to restore Firefox data from your old OS to Firefox on Fedora.
+
+You can also set up https://www.firefox.com/en-US/features/sync/[Firefox Sync^] which can transfer your passwords and bookmarks.
+
+=== Using LibreOffice
+
+https://www.libreoffice.org/[LibreOffice^] is a full-fledged office suite that comes pre-installed in Fedora.
+The suite consists of the following components:
+
+* Calc: do calculations in spreadsheets
+* Draw: create vector drawings
+* Impress: design and present slides
+* Math: write and typeset mathematical formulas
+* Writer: word processing
+
+LibreOffice uses the open source Open Document Format +
+It can read most file formats of other office suites.
+You should have not trouble opening and editing your existing documents.
+However, you should check the formatting of documents imported from commercial software, as commercial software often introduces new "features" which can mess with Open Document formats.  To fix this, recommend LibreOffice to your workmates :)
+
+LibreOffice is a full-featured suite. To learn how to use it, refer to https://help.libreoffice.org/latest/en-US/text/shared/05/new_help.html?&DbPAR=SHARED&System=UNIX[LibreOffice's extensive online help system^].
+
+LibreOffice has its own https://www.libreoffice.org/get-help/accessibility/[accessibility documentation^].
+
+=== Setting up a printer
+
+Fedora uses the CUPS print service for printing.
+You can use many printers using either USB or even network / wifi connections.
+
+To install the printer, either attach it to you computer via USB or connect it to you network. Switch on the printer.
+
+Open "System Settings > Printer".
+
+image::Printer_settings.png[Printer settings]
+
+Click "+ Add...". If your printer is supported, it will be discovered and you can add the printer after adjusting the settings.
+
+=== Using a scanner
+
+Fedora uses the http://www.sane-project.org/[SANE^] backend for scanning. Before using your scanner, locate it on the http://www.sane-project.org/sane-supported-devices.html["Supported Devices" page^] of the SANE project. If the scanner is supported, attach it to your computer and switch it on. Fedora will display a short notification if it is detected.
+
+To scan, open the Skanpage app from the application menu.
+
+image::Skanpage_start.png[Skanpage start]
+
+After adjusting the settings to your liking you can start scanning by clicking on "Scan".
+If you have multiple pages to scan, simply swap pages and click "Scan" again until all pages are scanned.
+You can save the scan and export it to PDF using the buttons at the top of Skanpage.
+
+=== Setting up sync'n'share
+
+KDE Plasma has out-of-the-box support for the for syncing images and documents:
+
+* ownCloud
+* Nextcloud
+* Other services
+
+To add these accounts, open "System Settings", find "Online Accounts" and click on "Add Account..." to configure your account. The pop-up dialogue will tell you what can be synchronized for each service and it will guide you through the login process.
+
+=== Gaming on Linux
+
+Linux has a limited number of high-quality games available from Fedora for free.
+You can download them from within Discover by searching them.
+
+* SuperTuxKart (cart racer with cartoon characters)
+* Oad (https://play0ad.com/[Zero AD^])
+* https://www.luanti.org/en/[Luanti^] (formerly known as Minetest; once Luanti is loaded, you will need to download a game such as "Minetest" from within Luanti)
+* https://xonotic.org/[Xonotic^] (arena shooter)
+
+Linux can also run AAA games, and games intended for Windows. +
+The primary tool for running Windows games is Wine, which stands for "Wine is not an emulator".
+
+To make things easy, a graphical Wine configurator is included in the Fedora repositories.  It is called Lutris and can be installed from Discover.
+
+Lutris can connect to internet gaming services, or it can install games you already have.
+
+Lutris also includes the automated installation of 'Retrogames'.  https://lutris.net/
+
+If a game does not run correctly in Lutris, a fix that often works is to change the Wine version by right clicking on the game and selecting configure > runner options > Wine version
+
+Commercial gaming stores are supported in Fedora.  You can find information regarding them elsewhere on the internet.
+
+=== Audio
+
+==== Music Playing
+
+Elisa is the default music player in KDE.  There are many more players available via Discover.
+
+==== Audio Editing
+
+Audacity is an audio recording and editing app.
+It features functions for noise reduction, speed change and much more.
+It is extendable via plugins and supports exporting audio in various formats.
+
+To install Audacity from Discover, search for "Audacity" or find it under "Multimedia > Audio and Video Editors".
+
+=== Video
+
+==== Video Playing
+
+Videos will open in Dragon Player by default.
+There are many more video players available in Discover and the Fedora repos.
+If you want to use a different player, right click on the file and 'open with' your installed player of choice.
+
+Out of the box, a fresh installation of Fedora KDE will only play fully free videos.  To enable closed source codecs, a quick online search will help you.
+
+==== Video Editing
+
+There is a powerful, non-linear video editor called https://kdenlive.org/[Kdenlive^] which integrates with KDE Plasma. It's available in Discover.
+
+Among other things it features
+
+* multi-track video / audio editing
+* title editor / generator
+* effects and filters for video and audio
+* proxy-editing for large video source files
+
+It even covers professional video editing requirements.
+
+=== Graphic Software
+
+Linux has _fantastic_ software for creating and manipulating images. All of the following apps are available in Discover:
+
+* Inkscape (vector graphics creation)
+* Krita (drawing and painting)
+* https://www.gimp.org/[GIMP^] (Graphical Image Manipulation Program)
+
+==== Screenshots
+
+KDE Plasma comes with the screenshot app Spectacle. It's located under "Utilities" in the Application Launcher.
+You can also use keyboard shortcuts to trigger a screenshot.
+
+Shortcuts include:
+
+* Print (Print Screen key): start Spectacle
+* Meta + Print: screenshot of active window
+* Shift + Print: screenshot of desktop
+
+There are many more shortcuts. Start Spectacle, click on "Options" > "Configure Spectacle..." > "Shortcuts" to view more.
+
+Spectacle can also do screen recordings and save them as videos.
+
+==== Photo viewing, management & editing
+
+Fedora contains amazing photo manipulation and digital asset management (DAM) software.
+You can find all the following applications in Discover under "Graphics > Photography".
+
+* Gwenview: comes pre-installed with your KDE desktop.
+You can find it under "Graphics > Gwenview" in the Application Launcher.
+* https://www.digikam.org/[digiKam^] is a photo organizer and a RAW photo developer with tools to edit photos. It integrates well with KDE.
+* https://rawtherapee.com/[RawTherapee^] develops RAW photos. It has many options to tweak your photos. It can also apply LUTs to give your photos a grading of your choice.
+* https://www.darktable.org/[darktable^] focusses on RAW image development, but implements a different UI concept than the previous two options.
+
+=== Making Backups
+
+We recommend you routinely make backups. Backups will help you when your hard drive fails and also when you accidentally delete data.
+
+One good option for managing backups is _KBackup_. Search for "KBackup" in Discover and install it. Afterward you can find it in the "Utilities" section of the Application Launcher. Once you start KBackup you will see a directory tree on the left-hand side.
+
+image::KBackup.png[KBackup]
+
+Regularly back up your home directory. Select it in `/home` (its name corresponds to your username).
+
+Create a backup profile by clicking on the "File" menu and select "Profile Settings".
+
+image::KBackup_Profile.png[KBackup Profile]
+
+If you want to save backups to removable media like a USB stick or an external hard drive, it makes sense to not keep unlimited backups but to limit the full backups to a certain number. Backing up you data every day is a good starting point. Click "OK" after adjusting the settings to your liking and save the profile from the "File" menu.
+
+In the main KBackup screen, select a target, for example the path to your removable media. Clicking "+ Start Backup" will then create your first backup.
+
+NOTE: A backup solution is only as good as your ability to actually restore data. KBackup will write so-called "tar balls" to your removable media. To restore data, attach your removable media, open Dolphin and browse it. To restore your data, double-click the oldest tar file and -- if you need to restore the data -- extract everything you want restored to /home. Since KBackup creates so-called "incremental backups", go through all tar files from oldest to youngest and extract your data from each of them.
+
+CAUTION: It's good practice to store your backup media safely. If you have a laptop it makes no sense to store your backup media in your laptop bag. If it gets stolen you lose both your laptop and your backup.
+
+=== Nvidia and Linux
+
+The latest graphics drivers for Nvidia graphics cards are not open source or free.  Therefore, *we do not recomend purchasing a PC to run Linux that has a Nvidia graphics card.* This may change in the future.
+
+AMD and Intel both have open source drivers available automatically in Fedora Linux.
+
+If you already have a computer with Nvidia, during installation of Fedora, the assistant asks you whether or not you would like to enable Third Party Repositories. One of those repositories contains the Nvidia drivers.
+
+If you are wondering "why don't they tell me exactly what to do with Nvidia and videos", it is due to legal reasons.  Closed source software has different licencing conditions and different legal ramifications in different countries.  This is one huge reason to go fully Open Source!
+
+Your other option is to use the free Nvidia 'nouveau' drivers that are included in Fedora - although they may not be suitable if you want to play AAA games.  To do this, simply do not install any optional repos.  If you need help with Nvidia, see the 'Getting Help' section below.
+
+=== Managing Fedora
+
+==== Updating Fedora
+
+Fedora software and operating system can be updated from within Discover.
+
+Select the "Updates" tab and wait for the package information refresh to finish. After that, you can click on "Update all" in the top right corner.
+
+==== Removing Software
+
+If you want to remove a piece of software, find it in the application launcher first.
+
+You can right click the app and select "Uninstall or manage add-ons". Discover will open after, select "Remove" in the top right corner.
+
+==== Upgrading Fedora to the Latest Release
+
+Fedora releases two new versions each year. 
+This guide covers Fedora release {fedora-release}. New versions are constantly released and at some point you'll want to upgrade to a newer version.
+
+You can upgrade with KDE Discover.  It will notify you.
+
+If you have problems using Discover to upgrade between numbered Fedora versions, you can upgrade via command line.  Follow the instructions at https://docs.fedoraproject.org/en-US/quick-docs/upgrading-fedora-offline/[^]
+
+=== Getting Help with Fedora
+
+The people at Fedora love helping!  We strive to be professional and friendly in our communications.
+
+You can get help with Fedora:
+
+On Matrix at https://chat.fedoraproject.org[^]
+in the https://matrix.to/#/#fedora:fedoraproject.org[#fedora room^]
+
+and
+
+on https://discussion.fedoraproject.org[^]
+
+When asking for help, please tell the team as much about your needs as possible. +
+You should include your Fedora version (e.g.) Fedora {fedora-release}, your desktop (KDE Plasma if you followed this guide), what has happened, and what you want to happen.
+You can find the versions of your Fedora installation as well as of your DE in the System Settings under "About this System".
+
+To branch out into the wide world of Fedora and the many possibilities we offer, visit https://fedoraproject.org[^].
+
+At this point, you should put this guide down, boot up Firefox, watch a video or play a game. +
+Come back and learn more when you are comfortable.
+
+You are now a Linux user!

modules/ROOT/pages/faq.adoc

@@ -1,7 +0,0 @@
-= Frequently Asked Questions (FAQ)
-
-[qanda]
-Can I see a built preview of this template to get a better idea about the result?::
-    Of course you can! Just look at the README of the repository — it should tell you everything.
-Is writing documentation hard and dreadful?::
-    Absolutely not. Writing documentation in asciidoc is very simple and straightforward. And in fact, writing documentation makes you very happy. Just try and see for yourself!

modules/ROOT/pages/index.adoc

@@ -1,13 +1,51 @@
 include::partial$attributes.adoc[]
 
-= The Pizza Project
-John Doe; Jane Doe
-:page-authors: {author}, {author_2}
+= Introduction
+Christian Strauf; Mat Holmes
+:page-authors: Christian Strauf, Mat Holmes
 
-The Pizza Project is a useful project with a very bad name — it helps you with writing some new documentation for Fedora.
+Last updated: {year}
 
-In fact, this is just a source template for a new piece of the Fedora Docs.
+Welcome to Fedora, we're glad to have you here!
+This guide will help you get started with Fedora Linux, a Free Operating System.
+We will help you install Fedora and all the software you need to get productive.
+With this guide you should be able to replace other commercial operating systems and still have full functionality.
 
-image::pizza.png[Pizza]
+== What is The Fedora Project?
 
-Last updated in {year}.
+https://fedoraproject.org/[The Fedora Project^] is a community of people working together to build a free and open source operating system. +
+We value https://docs.fedoraproject.org/en-US/project/#_what_is_fedora_all_about[Freedom, Friends, Features and First^].
+You will find that we are a respectful and inclusive community.  We don't only build an operating system, we build a community that helps make computing accessible to everybody. Our development defaults to 'open' - you could come and see us at work if you wanted.
+Find more details on the project on https://docs.fedoraproject.org/en-US/project/#_what_is_fedora[What is Fedora^].
+
+_The Fedora Project_ is sponsored by Red Hat, which is owned by IBM.
+
+[discrete]
+==== Our Working Language
+
+The working language of the Fedora Project is English,however, Fedora is localized in many other languages; you can select your preferred language during installation and it can be changed at any time later.  You can also join the Fedora translation team to ensure your language is included and up to date.  You could even translate this guide!
+
+== What is Fedora Linux?
+
+GNU/Linux (we'll call it _Linux_) is an _Operating System_.  You need an _Operating System_ to run all the other software you need to be productive or to play games.  Being _Open Source_, Linux is free to download, to use and to update.
+
+_Open Source_ software is developed and maintained by both individual users and by large companies.  _Open Source_ is shared amongst users, inventors and sponsors.  It powers home computers and large enterprise systems.
+
+You should use Fedora Linux if your current _Operating System_ can't be upgraded, if you don't want to pay for expensive hardware or if you value control and sovereignty over your own computing environment and data. In many cases it runs significantly faster than other operating systems on the same hardware.
+
+In this guide we will give you the instructions to install one version of Linux -- Fedora Linux -- with KDE Plasma Desktop.
+For the software you need, we will use the Mozilla suite for email and web-browsing, and LibreOffice for word-processing and spreadsheets. +
+Most of the software we will use is available in the official Fedora software repositories.
+
+_Fedora Linux_ makes operating systems for
+
+* desktop use (your home computer)
+* servers
+* Different CPU's such as ARM and RISC-V
+
+There are also different _Desktop Environments_ (DEs for short) you could use with Fedora.  These include Gnome and KDE which are the main DEs in https://fedoraproject.org/workstation/[Fedora Workstation^] and https://fedoraproject.org/kde/[Fedora KDE Plasma^] _Editions_ respectively. They are well-maintained and supported.
+
+We'll focus on https://fedoraproject.org/kde/[Fedora KDE Plasma Desktop^].
+Plasma Desktop is packaged by and available from Fedora, but is made by KDE (https://kde.org/plasma-desktop/[KDE Plasma^]).
+
+We have chosen to focus on KDE Plasma as it will look familiar to most people who've used a computer before.  Plasma is easy to use, up-to-date and has a large community to help support you.

modules/ROOT/pages/install_fedora.adoc

@@ -0,0 +1,83 @@
+== Installing Fedora KDE Permanently
+
+=== Step One: BACK UP ALL YOUR INFORMATION FROM YOUR EXISTING OPERATING SYSTEM
+
+We will guide you through replacing your current OS with Fedora so installing Fedora will delete all of your current files, folders and information.  This action is NOT reversible.  You must back up your files, folders and videos that you wish to keep.
+
+If you use Thunderbird on your old System, make sure to export your profile using https://support.mozilla.org/en-US/kb/thunderbird-export[this guide]. If you use Firefox on your old system, make sure to export your profile using https://support.mozilla.org/en-US/kb/back-and-restore-information-firefox-profiles[this guide] so that you can later on import it into Firefox on Fedora (see "Browsing the web"). Store the Thunderbird and/or Firefox profile on your backup media for later import.
+
+=== Step Two: Check your backups
+
+CAUTION: Check your backups and re-read Step One (above). We will not be responsible if you lose your data!
+
+=== Step Three: Install Fedora from the Live environment
+
+To install Fedora permanently, click on the "Install to Hard Drive" icon on your desktop:
+
+image::Install_to_hard_drive.png[Install to hard drive]
+
+This will open the installation wizard which will guide you through the installation. Most pages will be self-explanatory. However, we'll explain some of the installation options in more detail in the following sections.
+
+==== Setting Time and Date
+
+Leave it to Fedora to set date and time automatically (no changes are needed). However, we recommend that you manually select the correct timezone that you're in during installation. Untick the checkbox "Auomatically set timezone" and set it manually. The setting is on the "Date and time" installer screen.
+
+You can change the timezone later from KDE Settings if you need.
+
+==== Install Destination
+
+When asked for the installation destination, make sure your computer's hard drive is selected and choose "Use entire disk".
+
+WARNING: This will ERASE ALL DATA on the selected disk.
+
+==== Encryption - yes or no?
+
+During storage configuration you have the option to encrypt your data on the hard drive. Using encryption has some advantages and drawbacks. You decide!
+
+image::Hard_drive_encryption.png[Hard drive encryption]
+
+Encryption will stop people from accessing your data when your computer is turned off or when you need to dispose of a broken hard drive.
+Decryption requires a passphrase. Without the passphrase it is impossible to recover the data on the disk. *Don't lose the passphrase!*
+
+==== User Account and Password
+
+After creating a user account for yourself and setting its password, we're good to go for installation! Leave "Enable root account" unchecked, you don't need to enable it.
+
+==== Go For It!
+
+You can review all settings and start the installation.
+When the installation is finished, return to your Live system, click the Fedora menu on the left hand side of the bottom menu bar and click on "Shut Down" to turn off your computer.
+Remove the USB drive and start the computer normally. This will boot into the freshly installed Fedora KDE. Log in with your user account and password.
+
+=== Step Four: Set up Internet & Install Updates
+
+You should set up your internet connection as described in "Connecting to Internet or Wifi" in the _Trying Out Fedora KDE Live_ section above.
+
+After connecting your computer to the internet, start the Discover app by clicking its icon in the menu bar:
+
+image::Discover_icon.png[Discover icon]
+
+Discover will open. +
+Select "Updates" from the menu on the left side.
+Click "Refresh" in the upper right corner.
+
+If Discover indicates that there are updates available, simply click "Update All" in the upper right corner:
+
+image::Discover_Updates.png[Discover Updates]
+
+As soon as all updates have been downloaded (which can take quite some time after a fresh installation), Discover will inform you that you should restart and install updates:
+
+image::Restart_and_Install_Updates.png[Restart and Install Updates]
+
+Click the corresponding button. Fedora will now reboot and install all updates.
+
+IMPORTANT: Discover can update your firmware as well as your software - if the manufacturer made the firmware available.
+Updating firmware is usually a good thing and you should let Fedora do all the necessary updates.
+*DO NOT interrupt firmware updates!*
+Leave your computer switched on and *DO NOT turn off power* even if the update takes a while!
+
+Fedora displays a progress screen during updates:
+
+image::Installing_Updates.png[Installing Updates]
+
+As soon as all updates are installed, Fedora reboots (perhaps more than once if firmware updates are installed). The process is finished when you see the login screen.

modules/ROOT/pages/pizza-dough.adoc

@@ -1,3 +0,0 @@
-= Pizza Dough Architecture
-
-I would never thought that a pizza dough can have an architecture. Yet here we are.

modules/ROOT/pages/pizza-oven.adoc

@@ -1,3 +0,0 @@
-= Pizza Oven Architecture
-
-Pizza oven architecture would be described on this page. Since this is just a template, I choose to disappoint you and not describe the pizza oven architecture.

modules/ROOT/pages/try_fedora.adoc

@@ -0,0 +1,94 @@
+== Let's Try Fedora!
+
+You will need to
+
+* Download Fedora Media Writer
+* Create a bootable USB
+* Try Fedora
+
+If you decide you like Fedora and want to install it you need to
+
+* Backup your existing data
+* Confirm you have backed up your existing data
+* Permanently install Fedora
+
+=== Downloading & making a bootable USB drive
+
+You will need to download _Fedora Media Writer_.  It will put _Fedora KDE Plasma_ on your USB drive, so you can install Fedora using that USB drive.
+
+To download _Fedora Media Writer_ go to https://github.com/FedoraQt/MediaWriter/releases/latest and select either the .exe file for Windows or the .dmg file for OSX.
+
+image::Fedora_Media_Writer_Download.png[Fedora Media Writer Download]
+
+Once you have downloaded _Fedora Media Writer_ for your current computer, install it on that computer.
+
+Next, run _Fedora Media Writer_ and select "Download automatically" and press "Next".
+
+image::Fedora_Media_Writer_select_iso_button.png[Select Image Source]
+
+Select the "Official Editions" checkbox, and "Fedora KDE Plasma Desktop" from the dropdown menu. +
+Press "Next".
+
+image::Fedora_Media_Writer_Select_Fedora_Release.png[Select Fedora Release]
+
+Select the latest "Version".
+If you are running a 'normal' X86 PC or Laptop, you will select Intel/AMD 64bit.  You will know if you need another option.
+Insert a blank USB drive (4GB or larger).
+
+CAUTION: The contents of the USB drive, if any, will be permanently erased.
+
+Select your USB drive under the "USB Drive" dropdown menu.
+Press the button "Download_Write".
+
+image::Fedora_Media_Writer_Write_Options.png[Write Options]
+
+Confirm "Download_Write".
+
+image::Fedora_Media_Writer_Erase_Warning.png[Erase Confirmation]
+
+Media writer will then download and check the file, and ask you again to "Write".
+
+Fedora will now be prepared for you -- wait until it finishes and *remove the USB drive before doing anything else*.
+
+=== Trying Out Fedora KDE Live
+
+Now you have Fedora installed on your USB drive, you can try it out.
+Don't worry -- it won't break your current system!
+
+Turn off your computer.
+Insert USB drive.
+You need to enter your computer's BIOS to enable booting from your USB drive. This is achieved by pressing a certain key immediately after you power "on" your PC. The most common keys are
+
+* F2
+* DEL
+* F10
+* F1
+* F12
+
+Please refer to your computer's manual or watch the startup screen closely.  Most manufacturers display the correct key on the boot-up screen.
+
+This will boot your computer into a selection menu where you can choose which drive to boot from.  Choose 'Fedora'.  If you have problems at this stage, you will have to search for your PC brand or model and look up how to select boot drive or enter BIOS.
+
+On selecting _Test this media & start Fedora-KDE-Desktop-Live_, Fedora will load and take you to your shiny new desktop. This is what we call the Live system: it is running off your USB drive - not permanently installed on your computer.
+
+* Try how it feels!  Press the icons, find the menu, open programs.
+* Does your hardware work?  If it seems a little slow, it may be due to your USB speed.  It will get faster once you 'install' Fedora on your main hard drive.
+* Try connecting to your network either with cable or wifi. You can even install software but note that all changes that you make to the Live system are lost on reboot -- this is a "test drive".
+
+Once you are ready, we can install Fedora permanently.
+
+IMPORTANT: Users with special needs should thoroughly try all required accessibility features before installing. Please see the xref:daily_driver.adoc#_accessibility["Fedora as your daily driver" > "Accessibility"] section of this guide for further information.
+
+=== Connecting to Internet or Wifi
+
+We strongly suggest you connect your live system to your network for the following reasons:
+
+* You can try browsing the web and other internet related applications
+* You can -- to some extent -- install packages you want to try
+* During the installation process, the clock on your computer can be set properly and timezone selection is facilitated
+
+If your computer has an ethernet port, the simplest way to connect to your network is to simply plug in a network cable that's connected to you LAN. As soon as you see the following symbol in your system tray your PC is properly connected via cable:
+
+image::Ethernet_connection.png[Ethernet connection]
+
+If you have a wifi adapter, find the wifi symbol in your system tray, click on it and select your wifi to connect. You'll be prompted for your wifi passphrase and after entering it, Fedora will connect.

modules/ROOT/partials/attributes.adoc

@@ -1 +1,2 @@
-:year: 2021
+:year: March 2026
+:fedora-release: 43

modules/ROOT/partials/partial-example.adoc

@@ -1,15 +0,0 @@
-This is an example of a partial file. Unlike files in `pages/`, files in this directory are not built as standalone pages, but only if they are included in a file within `pages/`. This stops fragments of pages being built and discovered by search engines.
-
-A file in this directory can be included within any file in the `pages/` directory.
-
-Most common use cases for partials are:
-
-. Reusing attributes such as the current year or a release version throughout the entire module while being able to change it easily (such as changing "Fedora 33" to "Fedora 34" when a new release comes out).
-. Reusing content such a banner or an infobox (`[NOTE]`, etc.) that appears on multiple pages and needs to have consistent content everywhere (such as a message on some of the quick-docs that warns the reader about their unreviewed status).
-
-In these cases, you can use a partial to include the same content in multiple places, and you only need to change it once to get the change to appear in every spot it's included in. You can see the first example used in `pages/index.adoc` in this repository; note the include statement on top.
-
-If you want to include this particular example somewhere, you can use the following syntax: `include::partial$partial-example.adoc[]`.
-Note the use of `partial$` instead of an actual file location.
-
-See link:https://docs.antora.org/antora/3.0/partials-directory/[Antora docs on partials] for more information about partials.

site.yml

@@ -1,6 +1,6 @@
 site:
   title: Local Preview
-  start_page: pizza-factory::index.adoc
+  start_page: beginners-guide::index.adoc
 content:
   sources:
    - url: .