Add First Run section by Yattatux · Pull Request #179 · fedora-silverblue/silverblue-docs

Yattatux · 2024-05-01T17:14:38Z

Added a "First Run" section for completeness and help for less experienced users.
Added a link for using Fedora Media Writer, and a new image of Fedora 40 in manual installation.
Added "Enable TRIM" and "Enable VAAPI Intel" in Tips & Tricks section.

I hope it goes well.

travier

Thanks for the PR!

Let's split this into multiple PRs as there are some parts where I'm not if we can include them. We can start with the installation page updates and then the tips & tricks updates.

modules/ROOT/pages/installation.adoc

travier · 2024-05-02T09:56:56Z

modules/ROOT/pages/installation.adoc

+== Preparing Boot Media
+Fedora images are `Hybrid ISOs` and can be used to create installation media with both optical and USB disks, for booting on both BIOS and UEFI systems.
+
+The best and easy way to make bootable USB media to install {variant-name} is to use Fedora Media Writer. Using it is strongly encouraged, although other USB media creation software can work as well.


Suggested change

The best and easy way to make bootable USB media to install {variant-name} is to use Fedora Media Writer. Using it is strongly encouraged, although other USB media creation software can work as well.

We recommend using Fedora Media Writer to make a bootable USB media to install {variant-name}. Other USB media creation software may work as well but are not regularly tested.

travier · 2024-05-02T09:58:34Z

modules/ROOT/pages/installation.adoc

+* Enable RPM Fusion: see the xref:tips-and-tricks.adoc#_enabling_rpm_fusion_repos[Enabling RPM Fusion repos] section
+* Enable TRIM in encrypt installation: see the xref:tips-and-tricks.adoc#_enable-trim-in-encrypt-installation[Enabling TRIM in encrypt installation] section
+* Enable Intel GPU Acceleration: see the xref:tips-and-tricks.adoc#_enabling-intel-gpu-acceleration[Enabling Intel GPU Acceleration] section
+* Using NVIDIA drivers: see the xref:troubleshooting.adoc#_using_nvidia_drivers[Using NVIDIA drivers] section
+* Install GNOME Tweaks: run the command
+
+ $ rpm-ostree install gnome-tweak-tool
+
+* Install Extension Manager:  run the command
+
+ $ flatpak install flathub org.gnome.Extensions
+
+* Install ffmpeg codecs: run the command
+
+ $ flatpak install org.freedesktop.Platform.ffmpeg-full
+
+* Play more videos in Firefox: see xref:faq.adoc#_How_can_I_play_more_videos_in_Firefox,_like_YouTube?[How can I play more videos in Firefox, like YouTube?] section or, alternatively run these commands
+
+ $ rpm-ostree override remove \
+    firefox \
+    firefox-langpacks \
+
+ $ flatpak install org.mozilla.firefox
+


Let's split those into independent Tips & tricks entries and and link to it instead.

travier · 2024-05-02T09:59:26Z

modules/ROOT/pages/tips-and-tricks.adoc

+
+To download the firmwares run the command:
+
+ $ rpm-ostree override remove mesa-va-drivers \


We'll have to link to the entry about RPM Fusion before those commands

Yattatux · 2024-05-02T15:09:11Z

Hello @travier :) thanks for suggestions.

I edited as your requests and updated the branch.

travier

Thanks. Can you split this into two PRs? The installation page changes should be ready to merge. The other ones will need some work and investigation to make sure we don't cross any legal constraints.

travier · 2024-05-02T16:09:46Z

modules/ROOT/pages/faq.adoc


 == About using {variant-name}

+[[how-can-i-play-more-videos-in-firefox-like-youtebe]]


Suggested change

[[how-can-i-play-more-videos-in-firefox-like-youtebe]]

[[how-can-i-play-more-videos-in-firefox-like-youtube]]

travier · 2024-05-02T16:11:57Z

modules/ROOT/pages/faq.adoc

 The one difference is that you use `rpm-ostree install` instead of `dnf install`.
-An alternative solution is to install https://flathub.org/apps/details/org.mozilla.firefox[Firefox from Flathub].
+
+An alternative solution is to install https://flathub.org/apps/details/org.mozilla.firefox[Firefox from Flathub] by running these commands:


We recommend hiding the default browser instead as that does not changes the image and the result is the same: https://docs.fedoraproject.org/en-US/fedora-silverblue/tips-and-tricks/#_hiding_the_default_browser_firefox

We also have a note about Flathub somewhere so we should link to that and to the Firefox page on Flathub instead of command lines ideally.

travier · 2024-05-02T16:12:55Z

modules/ROOT/pages/installation.adoc

+
+We recommend using Fedora Media Writer to make a bootable USB media to install {variant-name}. Other USB media creation software may work as well but are not regularly tested.
+
+You can see https://docs.fedoraproject.org/en-US/fedora/latest/preparing-boot-media/#_fedora_media_writer[Fedora Media Writer] section to learn to use it.


Suggested change

You can see https://docs.fedoraproject.org/en-US/fedora/latest/preparing-boot-media/#_fedora_media_writer[Fedora Media Writer] section to learn to use it.

See the https://docs.fedoraproject.org/en-US/fedora/latest/preparing-boot-media/#_fedora_media_writer[Fedora Media Writer] section to learn how to use it.

travier · 2024-05-02T16:15:05Z

modules/ROOT/pages/installation.adoc

+
+[IMPORTANT]
+====
+If you are new to {variant-name}, before installing software in your newly installed Fedora, Please read and understand the https://docs.fedoraproject.org/en-US/fedora-silverblue/getting-started/[Getting Started] section to consider the difference in software installation between: *Flatpak*, *Toolbox* e *Package layering* (rpm-ostree).


Let's try to be more gentle here:

Suggested change

If you are new to {variant-name}, before installing software in your newly installed Fedora, Please read and understand the https://docs.fedoraproject.org/en-US/fedora-silverblue/getting-started/[Getting Started] section to consider the difference in software installation between: *Flatpak*, *Toolbox* e *Package layering* (rpm-ostree).

If you are new to {variant-name} and before installing software in your newly installed Fedora, you should read the https://docs.fedoraproject.org/en-US/fedora-silverblue/getting-started/[Getting Started] section to learn about the difference between *Flatpak*, *Toolbox* and *package layering* (rpm-ostree).

Yattatux · 2024-05-02T19:06:02Z

Edited and updated the branch.

travier · 2024-05-03T12:43:18Z

Thanks. I've merged #180 so you should be able to rebase this one on top.

Yattatux · 2024-05-11T17:30:59Z

I think is ready to review.

travier · 2026-01-08T23:38:38Z

This documentation has been merged into the unified documentation for Fedora Atomic Desktops: https://docs.fedoraproject.org/en-US/atomic-desktops/

Please re-create your pull request for the new repo: https://forge.fedoraproject.org/atomic-desktops/docs

Thanks for contributing to Fedora docs.

first commit

df979cc

travier reviewed May 2, 2024

View reviewed changes

first update

753cd8f

travier reviewed May 2, 2024

View reviewed changes

second update

4ef5ee5

Merge branch 'master' into add-first-run

4b13203

	The best and easy way to make bootable USB media to install {variant-name} is to use Fedora Media Writer. Using it is strongly encouraged, although other USB media creation software can work as well.
	We recommend using Fedora Media Writer to make a bootable USB media to install {variant-name}. Other USB media creation software may work as well but are not regularly tested.


		To download the firmwares run the command:

		$ rpm-ostree override remove mesa-va-drivers \


		== About using {variant-name}

		[[how-can-i-play-more-videos-in-firefox-like-youtebe]]


		We recommend using Fedora Media Writer to make a bootable USB media to install {variant-name}. Other USB media creation software may work as well but are not regularly tested.

		You can see https://docs.fedoraproject.org/en-US/fedora/latest/preparing-boot-media/#_fedora_media_writer[Fedora Media Writer] section to learn to use it.

	You can see https://docs.fedoraproject.org/en-US/fedora/latest/preparing-boot-media/#_fedora_media_writer[Fedora Media Writer] section to learn to use it.
	See the https://docs.fedoraproject.org/en-US/fedora/latest/preparing-boot-media/#_fedora_media_writer[Fedora Media Writer] section to learn how to use it.

	If you are new to {variant-name}, before installing software in your newly installed Fedora, Please read and understand the https://docs.fedoraproject.org/en-US/fedora-silverblue/getting-started/[Getting Started] section to consider the difference in software installation between: Flatpak, Toolbox e Package layering (rpm-ostree).
	If you are new to {variant-name} and before installing software in your newly installed Fedora, you should read the https://docs.fedoraproject.org/en-US/fedora-silverblue/getting-started/[Getting Started] section to learn about the difference between Flatpak, Toolbox and package layering (rpm-ostree).

Conversation

Yattatux commented May 1, 2024

Uh oh!

travier left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

travier May 2, 2024

Choose a reason for hiding this comment

Uh oh!

travier May 2, 2024

Choose a reason for hiding this comment

Uh oh!

travier May 2, 2024

Choose a reason for hiding this comment

Uh oh!

Yattatux commented May 2, 2024

Uh oh!

travier left a comment

Choose a reason for hiding this comment

Uh oh!

travier May 2, 2024

Choose a reason for hiding this comment

Uh oh!

travier May 2, 2024

Choose a reason for hiding this comment

Uh oh!

travier May 2, 2024

Choose a reason for hiding this comment

Uh oh!

travier May 2, 2024

Choose a reason for hiding this comment

Uh oh!

Yattatux commented May 2, 2024

Uh oh!

travier commented May 3, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Yattatux commented May 11, 2024

Uh oh!

travier commented Jan 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

travier commented May 3, 2024 •

edited

Loading