Update to FreeBSD handbook: virtualization chapter

[freebsd_ny-central.org]

Summary

Expanding documentation around bhyve

• snapshot feature (experimental)
• additional notice about persisting and changing network configuration and potential for locking oneself out
• jailing bhyve

I should probably add, that I'm more than willing to remove the part on snapshots, because it's certainly very experimental. On the other hand, this might invite more people to test and try things out.

Feedback - as usual - very welcome!

[emaste]

documentation/content/en/books/handbook/virtualization/_index.adoc

500–506

We mention Intel and AMD; should we reference Arm as well?

[freebsd_ny-central.org]

Valid point on ARM - I've added a suggestion on ARM though I ain't an expert on the topic.
I got those infos from here: https://cgit.freebsd.org/src/commit/?id=47e073941f4e

[freebsd_ny-central.org]

documentation/content/en/books/handbook/virtualization/_index.adoc

500–506

Actually, now rereading what I wrote... this makes no sense. I'll change this again.

[freebsd_ny-central.org]

Restructured into a bullet point list; certainly better to read - hope the content is correct though.

[pauamma_gundo.com]

Bunch of small things I spotted.

documentation/content/en/books/handbook/virtualization/_index.adoc

904

909

2nd-person pronoun use is discouraged.

948

955

999

1006

1014

1022

1030

Shouldn't it be the same as the host's?

1035

Also, with 13.3 days from expected release, maybe wait a bit and use that as an example, for future-proofing?

1068

1073

1085

1146

1147

1192

1238

1243

1245

1258

For consistency with the actual examples

1278–1280

Why not pkg -j bhyve install bhyve-firmware?

[freebsd_ny-central.org]

Updated after feedback. Thanks for the great inputs!

[pauamma_gundo.com]

A few typos remain, but getting close, I think.

documentation/content/en/books/handbook/virtualization/_index.adoc

904

"additionally" and "reasonably" misspelled.

948

Spurious "if you"

[freebsd_ny-central.org]

Thanks for spotting those. I really need to run a spellcheck before I submit things. Apologies for the extra round.
Added additional typo and comma fixes and improvements for brevity.

[jrm]

documentation/content/en/books/handbook/virtualization/_index.adoc

566–567

786

Does this sound clearer?

811

812–813

I removed instances of the second person as Pau Amma requested in other reviews and suggested an alternative wording.

820

861

864

869

895

903

904

924

937–947

Would it be better to link to Quick Start section of the Updating and Upgrading FreeBSD chapter? The shell source at the top is nearly the same as here.

[freebsd_ny-central.org]

Thanks for the feedback. I've merged all suggested changes and also

• removed a few more "you" statements to a more neutral version
• added a note/recommendation on using UEFI vars file w/ Linux to prevent having to rename boot files