git: 184a6af025 - main - handbook/bsdinstall: Suggest and reference virtualization

The branch main has been updated by jrm:

URL: https://cgit.FreeBSD.org/doc/commit/?id=184a6af025571ff232d2c4153ddf17569ad78db5

commit 184a6af025571ff232d2c4153ddf17569ad78db5
Author:     Chris Moerz <[email protected]>
AuthorDate: 2024-03-18 13:22:25 +0000
Commit:     Joseph Mingrone <[email protected]>
CommitDate: 2024-03-18 13:24:31 +0000

    handbook/bsdinstall: Suggest and reference virtualization
    
    - Add a TIP pointing to virtualization
    - Add a reference to virtualization as alternative to changing
      partitions
    
    PR:             263324
    Reviewed by:    jrm, Pau Amma <[email protected]>
    Differential Revision:  https://reviews.freebsd.org/D44393
---
 .../content/en/books/handbook/bsdinstall/_index.adoc          | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/documentation/content/en/books/handbook/bsdinstall/_index.adoc b/documentation/content/en/books/handbook/bsdinstall/_index.adoc
index 0b02e5c6a6..9e4c5cf068 100644
--- a/documentation/content/en/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/en/books/handbook/bsdinstall/_index.adoc
@@ -82,7 +82,13 @@ The link:https://www.FreeBSD.org/where/[FreeBSD download page] also has recommen
 == Pre-Installation Tasks
 
 Once it has been determined that the system meets the minimum hardware requirements for installing FreeBSD, the installation file should be downloaded and the installation media prepared.
-Before doing this, check that the system is ready for an installation by verifying the items in this checklist:
+
+[TIP]
+====
+Consider using crossref:virtualization[virtualization,virtualization] if you want to use FreeBSD on a system that already has another operating system installed.
+====
+
+Before moving on to the installation, check that the system is ready by verifying the items in this checklist:
 
 [.procedure]
 ====
@@ -109,6 +115,8 @@ The FreeBSD boot loader requires either a primary or GPT partition.
 If all of the primary or GPT partitions are already in use, one must be freed for FreeBSD.
 To create a partition without deleting existing data, use a partition resizing tool to shrink an existing partition and create a new partition using the freed space.
 +
+An alternative to modifying the system's existing disk partitions is to use crossref:virtualization[virtualization,virtualization], which allows multiple operating systems to run at the same time without having to alter partitions.
++
 A variety of free and commercial partition resizing tools are listed at link:https://en.wikipedia.org/wiki/List_of_disk_partitioning_software[List of disk partitioning software wikipedia entry].
 link:https://gparted.org/livecd.php[GParted Live] is a free live CD which includes the GParted partition editor.
 +
@@ -119,7 +127,6 @@ Since the possibility of selecting the wrong partition exists, always backup any
 ======
 +
 Disk partitions containing different operating systems make it possible to install multiple operating systems on one computer.
-An alternative is to use crossref:virtualization[virtualization,virtualization] which allows multiple operating systems to run at the same time without modifying any disk partitions.
 . *Collect Network Information*
 +
 Some FreeBSD installation methods require a network connection in order to download the installation files.