[f36] Doc issue [ Deeply Nested Paragraph Heading Levels ] in file modules/install-guide/pages/index.adoc
MW users are now realizing MW11 requires 64 GB. All of those users are now potential Fedora users. How many of those potential Fedora users will get lost at step # 1, the Installation Guide ? Users appreciate extremely usable documents. Installation is a chronological series of steps. That is what an installation document should be. This is a once in a lifetime opportunity for Fedora and IBM.
The Fedora Installation Guide contains paragraph levels that nested 5 and 6 levels deep, maybe more. The deeply nested paragraphs make the chronological order of the steps hidden, minimal and extremely vague. So, this is a once in a lifetime opportunity for improvement. One time only. ( I doubt there will be second chances. That's not the kind of world we live in anymore ).
DOCUMENT URL: https://docs.fedoraproject.org/en-US/fedora/latest/install-guide/install/Preparing_for_Installation/#sect-preparing-upgrade-or-install SECTION NAME : Upgrade or Install? ERROR OR SUGGESTION : DELETE this [ duplicate ] section. ADDITIONAL INFORMATION : Upgrading is done after Installing and section '' Upgrading Your Current System '' contains this upgrading information.
DOCUMENT URL: https://docs.fedoraproject.org/en-US/fedora/latest/install-guide/install/Preparing_for_Installation/#sect-preparing-boot-media SECTION NAME : Preparing Boot Media ERROR OR SUGGESTION : '' Preparing Boot Media '' must [ always ] be done after '' Downloading Fedora '' [ and before '' Installing Fedora '' ] . MOVE '' Preparing Boot Media '' [ and all subSections ] to a level 1 heading after '' Downloading Fedora ''. ADDITIONAL INFORMATION : The subSections are [ and to be Level 2 Headings ] . . . Fedora Media Writer, Installing and running Fedora Media Writer, Writing the ISO image to the USB Media, Other methods to create a live USB, Writing the images to USB media, Creating a Boot CD or DVD }. Writing the images to USB media, Creating a Boot CD or DVD .
DOCUMENT URL : https://docs.fedoraproject.org/en-US/fedora/latest/install-guide/install/Preparing_for_Installation/#_other_methods_to_create_a_live_usb SECTION NAME : Other methods to create a live USB ERROR OR SUGGESTION : The content of '' Other methods to create a live USB '' is [ actually ] about Downloading. RENAME as '' Other Downloading Methods ''. ADDITIONAL INFORMATION : In addition to the above MOVE, also include the subsection '' Downloading Boot and Installation Images ''.
DOCUMENT URL : https://docs.fedoraproject.org/en-US/fedora/latest/install-guide/install/Preparing_for_Installation/#sect-verifying-images SECTION NAME : Verifying the Downloaded Image ERROR OR SUGGESTION : The ERROR is the '' Verifying the Downloaded Image '' is at the WRONG heading level. DECREMENT the heading level to unindent. ADDTIONAL INFORMATION :
DOCUMENT URL : https://docs.fedoraproject.org/en-US/fedora/latest/install-guide/install/Booting_the_Installation/ SECTION NAME : Booting the Installation ERROR or SUGGESTION : This section has only one ( very unecessary ) sentence. DELETE the sentence. DELETE the section. ADDITIONAL INFORMATION : The remaining two subections are, '' Preparing To Boot '' and '' The Boot Menu ''. DECREMENT their heading levels to unindent.
DOCUMENT URL : https://docs.fedoraproject.org/en-US/fedora/latest/install-guide/install/After_Installation/ SECTION NAME : '' After the Installation '' ERROR or SUGGESTION : DECREMENT heading level until this is a Level 1 Heading. ADDITIONAL INFORMATION : The subsections are [ and to be ] at heading level 2 . . . Initial Setup GNOME Initial Setup Common Post-installation Tasks
DOCUMENT URL : https://docs.fedoraproject.org/en-US/fedora/latest/install-guide/install/Troubleshooting/ SECTION NAME : '' Troubleshooting '' ERROR or SUGGESTION : DECREMENT heading level until '' Troubleshooting '' is at Level 1 ( i.e. no indentation. ) MOVE this section to after '' Installing Fedora '' [ and before '' After The Installation ]. ADDITIONAL INFORMATION : Adjust / decrement the subsection heading levels.
DOCUMENT URL : https://docs.fedoraproject.org/en-US/fedora/latest/install-guide/advanced/Network_based_Installations/ SECTION NAME : '' Setting Up an Installation Server '' ERROR or SUGGESTION : DECREMENT the '' Setting Up an Installation Server '' heading level to Level 1 Heading. ( i.e. no indentation. ) ADDITIONAL INFORMATION : Adjust / decrement subsection heading levels accordingly.
DOCUMENT URL : https://docs.fedoraproject.org/en-US/fedora/latest/install-guide/advanced/VNC_Installations/ SECTION NAME : '' Installing Using VNC '' ERROR or SUGGESTION : DECREMENT heading level until it becomes a Level 1 heading. ( i.e. no indentation. ) ADDITIONAL INFORMATION : Adjust / decrement subsection heading levels accordingly.
DOCUMENT URL : https://docs.fedoraproject.org/en-US/fedora/latest/install-guide/advanced/Upgrading_Your_Current_System/ SECTION NAME : '' Upgrading Your Current System '' ERROR or SUGGESTION : DECREMENT the heading level until it is a Level 1 heading. ADDITIONAL INFORMATION : RENAME to '' Updating and Upgrading Fedora''. ADD updating information.
Implementing the above comments would be a giant step in the right direction.
Red Hat's install document " may " also be used as a guide / example . . .
Performing a standard RHEL 9 installation https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/performing_a_standard_rhel_9_installation/index