Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

misleading text in "Writing" step #524

Open
skierpage opened this issue May 30, 2022 · 2 comments
Open

misleading text in "Writing" step #524

skierpage opened this issue May 30, 2022 · 2 comments

Comments

@skierpage
Copy link

I followed https://docs.fedoraproject.org/en-US/fedora/latest/install-guide/install/Preparing_for_Installation/#_writing_the_iso_image_to_the_usb_media to write the Fedora 36 KDE spin with the Media Writer package mediawriter-5.0.1-1.fc35.src.rpm

During the "Writing Fedora KDE Plasma Desktop 36" step, it displays

Your drive will be resized to a smaller capacity ...

Future tense is wrong, it's already happening. This should be "This step resizes your USB drive to a smaller capacity."
It goes on:

You may resize it back to normal by using Fedora Media Writer.
This will remove installation media from your drive

I didn't understand this. After Media Writer finished writing the only instruction was to reboot, and it's unclear what "This" refers to: the current step (which has already trashed whatever is on the drive), or using Media Writer.

I restarted Media Writer and inserted my USB flash drive, and a new option "Restore SanDisk Cruzer (4.0 GB)" appeared. So this actually is a feature of Media Writer (cool! 😎), but it should be phrased better, e.g.

This step resizes your USB drive to a smaller capacity.
Later, when you have finished installing or trying out Fedora, you can re-run Media Writer and restore your USB drive to its original capacity.

I was too scared to actually choose "Restore my USB drive", but I assume choosing that step would warn about removing whatever's on the drive, so there's little point in mentioning a detail of a feature the user isn't going to use for a while.

@ferdnyc
Copy link

ferdnyc commented Dec 28, 2023

"Restore" seems a particularly poor choice of term, because when working with physical media, "Restore" refers to backups. FMW doesn't take any kind of backups, and it can't restore anything to your USB device.

(Heck, it's not even restoring the original layout, unless the original layout happens to have been single-partition FAT32. If it at least stored the original partition table before overwriting it, and then put the drive back the way it was originally — except, empty, obviously — then I could maybe see a case for "Restore".)

The functionality it actually provides is something more akin to "Remove" or "Reset", than "Restore".

@ferdnyc
Copy link

ferdnyc commented Dec 28, 2023

("Remove" isn't great due to its having an association with ejecting removable drives, so maybe "Remove Fedora".)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants