After sorting out the BIOS configuration issues, the installation was smooth. I would still like to make some comments on troubles I had. I don’t find these proposed changes as necessary at all and are mostly opinion based, but I would still like to report them.
I found the documentation to be very robust already. But I would still change some details.
On System requirements:
- At least 4GiB of RAM (for system use only): What it seems like to me is that the system itself needs 4GiB of memory, which indicates more than 4GiB is a requirement. Is this the correct understanding? This is mostly a question and I don’t have proposed changes here. Could maybe be made clearer, or reference to a better discussion on the end of the same page, as too much text right on the start would not be great.
- At least one wired network port: I would (add/change to) internet/network connectivity. It installs fine without it, but it errors out on first boot with NTP synchronisation and connectivity for Secure Boot Key updates.
I made a mistake on selecting the install media. For this, I checked the documentation a few times trying to see what could have led me off and wanted to report.
On the Image Customizer page, Image type contains ISO and USB options. Note that ISO is a file format while USB is a medium for installation. Since the byte alignment makes a huge difference on the media being recognised, options should be of the same type and probably lean towards the medium of installation. Furthermore, the default is selected to ISO and it is a file format which is usually not an issue to install through USB, so I think some improvements could be made here.
I would change ISO to Virtual and also delete the trailing closing parenthesis. I’m probably biased on the default value, but USB could be considered as a better option. It would probably be nice to add a comment that those options have different byte alignments and might be a reason for the media not to be recognised. Preferably a short description without too much detail.
On the Getting an image page, it starts with
ISO and raw images are distributed via the Linux Containers CDN.
This together with the ISO and USB options, and the fact that most installation media is distributed through ISO format, led me to believe it was the preferable option. Would change to
Images are distributed via the Linux Containers CDN.
The comment of not using the iso format for usb is only inside the Flasher tool section, in which it states
When run, you will first be prompted for the image format you want to use, either iso (default) or an img (raw) disk image. Note that the ISO isn’t a hybrid image; if you want to boot from a USB stick you should choose the img disk image format.
Although I saw this comment yesterday after @stgraber pointed out the difference in file formats, only today I noticed it is in another section.
Might be best to have a common section in which this is mentioned.