Added 'btn' and 'menu' macros for further consistency

README.md

@@ -12,6 +12,15 @@ Due to the nature of this guide, please try to write any contributions with the
 * take the beginner seriously; onboarding with Linux can be daunting
 * reference other Fedora documentation if possible
 
+## Important formatting rules
+
+If you want to document keyboard shortcuts or key presses, menu selections or UI button presses, please add the `:experimental:` attribute at the top of your page.
+Please consult the AsciiDoc documentation for:
+
+* [Button and Menu UI Macros](https://docs.asciidoctor.org/asciidoc/latest/macros/ui-macros/)
+* [Keyboard Macro](https://docs.asciidoctor.org/asciidoc/latest/macros/keyboard-macro/)
+
+
 ## Local preview
 
 This repo includes a script to build and preview the contents of this repository.

modules/ROOT/pages/daily_driver.adoc

@@ -47,8 +47,8 @@ We recommend you use this method until you want to learn to use the command line
 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.
+Take your time to explore your settings and make use of the btn:[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 btn:[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.
@@ -192,7 +192,7 @@ Lutris can connect to internet gaming services, or it can install games you alre
 
 https://lutris.net/[Lutris] also includes the automated installation of 'Retrogames'.
 
-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
+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.
@@ -259,7 +259,7 @@ Shortcuts include:
 * kbd:[Shift+Print Screen]: screenshot of desktop
 
 There are many more shortcuts.
-Start Spectacle, click on "Options" > "Configure Spectacle..." > "Shortcuts" to view more.
+Start Spectacle, click on "Options > Configure Spectacle... > Shortcuts" to view more.
 
 Spectacle can also do screen recordings and save them as videos.
 
@@ -309,15 +309,15 @@ 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".
+Create a backup profile by clicking on "File > 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.
+Click btn:[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.
+In the main KBackup screen, select a target, for example the path to your removable media. Clicking btn:[+ 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.
@@ -355,14 +355,14 @@ If you need help with Nvidia, see the 'Getting Help' section below.
 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.
+After that, you can click on btn:[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.
+Discover will open after, select btn:[Remove] in the top right corner.
 
 ==== Upgrading Fedora to the Latest Release
 

modules/ROOT/pages/install_fedora.adoc

@@ -1,4 +1,5 @@
 == Installing Fedora KDE Permanently
+:experimental:
 
 === Step One: BACK UP ALL YOUR INFORMATION FROM YOUR EXISTING OPERATING SYSTEM
 
@@ -7,7 +8,7 @@ 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").
+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 xref:daily_driver.adoc#_browsing_the_web[Browsing the web]).
 Store the Thunderbird and/or Firefox profile on your backup media for later import.
 
 === Step Two: Check your backups
@@ -76,9 +77,9 @@ 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.
+Click btn:[Refresh] in the upper right corner.
 
-If Discover indicates that there are updates available, simply click "Update All" in the upper right corner:
+If Discover indicates that there are updates available, simply click btn:[Update All] in the upper right corner:
 
 image::Discover_Updates.png[Discover Updates]
 

modules/ROOT/pages/try_fedora.adoc

@@ -24,12 +24,12 @@ 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".
+Next, run _Fedora Media Writer_ and select "Download automatically" and press btn:[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".
+Press btn:[Next].
 
 image::Fedora_Media_Writer_Select_Fedora_Release.png[Select Fedora Release]
 
@@ -41,11 +41,11 @@ 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".
+Press the button btn:[Write].
 
 image::Fedora_Media_Writer_Write_Options.png[Write Options]
 
-Confirm "Download_Write".
+Confirm btn:[Download_Write].
 
 image::Fedora_Media_Writer_Erase_Warning.png[Erase Confirmation]