Page MenuHomeFreeBSD

[handbook] reorganize installation section
ClosedPublic

Authored by carlavilla on Mar 18 2020, 3:21 PM.
Tags
None
Referenced Files
F80165459: D24116.diff
Thu, Mar 28, 7:18 PM
Unknown Object (File)
Dec 20 2023, 3:50 AM
Unknown Object (File)
Dec 11 2023, 2:15 AM
Unknown Object (File)
Dec 5 2023, 6:07 PM
Unknown Object (File)
Nov 17 2023, 5:11 AM
Unknown Object (File)
Nov 11 2023, 2:46 PM
Unknown Object (File)
Nov 9 2023, 2:00 PM
Unknown Object (File)
Nov 8 2023, 12:48 AM
Subscribers
None

Details

Summary

Reorganize the installation section to follow the bsdinstall steps

Minor corrections

Test Plan

Compile the handbook

Diff Detail

Repository
rD FreeBSD doc repository - subversion
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

A few comments, but I'm generally glad this gets added to the handbook.

en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
1092

I think the "Or" can be removed here.

1094

s/this/these/

1097

This sentence needs to be after the "...<filename>-mini-memstick.img</filename>." sentence.
I'm fairly sure the disc1.iso and memstick images contains the installation files and they don't need to be retrieved from the internet.

1100

s/first configured/configured first/

1100

s/menu shown/menu is shown/

2135

s/skipped pressing/skipped by pressing/

2152

s/skipped pressing/skipped by pressing/

2871

Can you shorten this to have the link just say "RFC4862" instead of the full link to the IETF document?

carlavilla marked 7 inline comments as done.

Fixed. Please can you take a look at the first paragraph? I don't if it's enough clear...

OK, we're getting there. Just one sentence that needs the be extended a bit and we're good.

en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
9

This is an if-sentence, but there is no "then" part at the end. I guess you wanted to say here that if disc1.iso or memstick.img is selected, then the installation files are fetched directly from the media without having to go to the internet.

Well... I think that's better in this way. It's much more clear for the user.

Yes, that's better. We'll use this version for now and can improve it later if necessary.

This revision is now accepted and ready to land.Mar 18 2020, 6:37 PM