Page MenuHomeFreeBSD

[handbook] reorganize installation section
ClosedPublic

Authored by carlavilla on Wed, Mar 18, 3:21 PM.

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
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

carlavilla updated this revision to Diff 69641.Wed, Mar 18, 3:21 PM
carlavilla created this revision.
bcr added a comment.Wed, Mar 18, 3:56 PM

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

en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
1092 ↗(On Diff #69641)

I think the "Or" can be removed here.

1094 ↗(On Diff #69641)

s/this/these/

1097 ↗(On Diff #69641)

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 ↗(On Diff #69641)

s/first configured/configured first/

1100 ↗(On Diff #69641)

s/menu shown/menu is shown/

2135 ↗(On Diff #69641)

s/skipped pressing/skipped by pressing/

2152 ↗(On Diff #69641)

s/skipped pressing/skipped by pressing/

2871 ↗(On Diff #69641)

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

carlavilla updated this revision to Diff 69646.Wed, Mar 18, 4:40 PM
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...

bcr added a comment.Wed, Mar 18, 4:47 PM

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 ↗(On Diff #69646)

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.

carlavilla updated this revision to Diff 69654.Wed, Mar 18, 6:24 PM

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

bcr accepted this revision.Wed, Mar 18, 6:37 PM

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.Wed, Mar 18, 6:37 PM