Add First Run section #179
Open
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
travier
reviewed
May 2, 2024
modules/ROOT/pages/installation.adoc
Outdated
| == 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. |
There was a problem hiding this comment.
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. |
modules/ROOT/pages/installation.adoc
Outdated
Comment on lines
100
to
123
| * 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 | ||
|
|
There was a problem hiding this comment.
Let's split those into independent Tips & tricks entries and and link to it instead.
|
|
||
| To download the firmwares run the command: | ||
|
|
||
| $ rpm-ostree override remove mesa-va-drivers \ |
There was a problem hiding this comment.
We'll have to link to the entry about RPM Fusion before those commands
|
Hello @travier :) thanks for suggestions. I edited as your requests and updated the branch. |
travier
reviewed
May 2, 2024
modules/ROOT/pages/faq.adoc
Outdated
| @@ -27,12 +27,20 @@ However, {variant-name} is specifically focused on workstation and desktop use c | |||
|
|
|||
| == About using {variant-name} | |||
|
|
|||
| [[how-can-i-play-more-videos-in-firefox-like-youtebe]] | |||
There was a problem hiding this comment.
Suggested change
| [[how-can-i-play-more-videos-in-firefox-like-youtebe]] | |
| [[how-can-i-play-more-videos-in-firefox-like-youtube]] |
modules/ROOT/pages/faq.adoc
Outdated
| === How can I play more videos in Firefox, like YouTube? | ||
|
|
||
| Firefox is included in the OS image for now (see https://github.com/fedora-silverblue/issue-tracker/issues/288[issue#288] for progress on moving to Flatpak by default). | ||
| Until that changes, getting it to play videos works the same way as it does for the regular {variant-classic}: find a package with the needed codecs, and install it. | ||
| 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: |
There was a problem hiding this comment.
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.
modules/ROOT/pages/installation.adoc
Outdated
|
|
||
| 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. |
There was a problem hiding this comment.
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. |
modules/ROOT/pages/installation.adoc
Outdated
|
|
||
| [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). |
There was a problem hiding this comment.
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). |
|
Edited and updated the branch. |
|
Thanks. I've merged #180 so you should be able to rebase this one on top. |
|
I think is ready to review. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
I hope it goes well.