Differential D8252

Bug report #213468 (https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=213468):
ClosedPublic
Actions

Authored by timmoore88_gmail.com on Oct 14 2016, 6:23 PM.

Tags

None

Referenced Files

	Unknown Object (File)
	Thu, Aug 27, 7:03 AM

	Unknown Object (File)
	Thu, Aug 27, 7:02 AM

	Unknown Object (File)
	Tue, Aug 25, 8:20 AM

	Unknown Object (File)
	Tue, Aug 25, 7:22 AM

	Unknown Object (File)
	Tue, Aug 25, 7:21 AM

	Unknown Object (File)
	Wed, Aug 12, 2:05 AM

	Unknown Object (File)
	Sat, Aug 8, 7:13 PM

	Unknown Object (File)
	Thu, Aug 6, 5:59 AM

Subscribers

None

Details

Reviewers

Commits

rD49539: Explain the difference between memstick.img and mini-memstick.img.

Summary

FreeBSD Handbook chapter 2.3.1 Prepare the Installation Medium (https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bsdinstall-pre.html):
Added entry for "mini-memstick" using discovered information:
https://www.freebsd.org/releases/10.1R/announce.html
https://forums.freebsd.org/threads/51903/

Igor test cleared, build test cleared.

Diff Detail

Repository

rD FreeBSD doc repository - subversion

Lint

Lint Skipped

Unit

Tests Skipped

Event Timeline

timmoore88_gmail.com updated this revision to Diff 21398.Oct 14 2016, 6:23 PM

timmoore88_gmail.com retitled this revision from to Bug report #213468 (https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=213468):.

timmoore88_gmail.com updated this object.

timmoore88_gmail.com edited the test plan for this revision. (Show Details)

timmoore88_gmail.com added a reviewer: wblock.

timmoore88_gmail.com set the repository for this revision to rD FreeBSD doc repository - subversion.

timmoore88_gmail.com updated this object.

wblock added inline comments.Oct 14 2016, 6:32 PM

en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
493	"This file" is not needed, the reader already knows it is a file. Maybe just leave that out and start with Like <literal>-bootonly</literal>, does not include installation files, but downloads them as needed. A working internet connection is required during installation. (Note: "internet" no longer needs capitalization: http://www.poynter.org/2016/ap-style-change-alert-dont-capitalize-internet-and-web-any-more/404664/)
497	Two spaces before a new sentence, but the redundant "This file" can be better. "Should be burned" is kind of passive, and files aren't really "burned" to USB flash. How about: Write this file to a <acronym>USB</acronym> memory stick as shown in (link). Link goes to the write a memory stick instructions.

Addressed comments

wblock added inline comments.Oct 14 2016, 7:03 PM

en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
499	This should go to the directory section: https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bsdinstall-pre.html#bsdinstall-usb See https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/docbook-markup-links.html#docbook-markup-links-to-web-documents for how to generate the URL. There are spaces in the link title, so this should be wrapped.

Updated link

wblock added inline comments.Oct 14 2016, 7:20 PM

en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
499	Sorry, this is in the same document. So this should be an <xref>.

Changed link to an xref internal link.
Build test and Igor came back clean.

Closed by commit rD49539: Explain the difference between memstick.img and mini-memstick.img. (authored by wblock). · Explain WhyOct 21 2016, 8:31 PM

This revision was automatically updated to reflect the committed changes.

Revision Contents
Changeset List

Path

Size

en_US.ISO8859-1/

books/

handbook/

bsdinstall/

11 lines

Diff 21401

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

Loading...