Currently, the instructions for how to build/upgrade/install FreeBSD start at line 1,371, and that number keeps getting higher.
Surely that information is more important than the notes from 5 years ago that sit above it.
I would like to propose pulling the "COMMON ITEMS" stuff into a new file. GNU has got people trained to look for that sort of thing in a file called INSTALL, so that's where I'd propose putting it: /usr/src/INSTALL.
Adding Warner to the CC list. Similar topic came up a while back, and he specifically requested to be a part of any changes in this regard.
(In reply to Glen Barber from comment #1)
I'm the one who brought it up before :-)
I had an issue recently where I needed the ZFS boot block command, and had to page through over 80 screens over a bad VNC connection to get to the good stuff on 10-RELEASE.
Oh, oops. :-)
"Thank you for the reminder," instead? :-)
I'd prefer we prune things for each major release, which we haven't done in far too long.
I'm not sure that moving it now would be a good idea. Let's see what pruning it back results in. Or maybe adding a 'search for XXX' to the top...
The installation instructions are now at line 1,868 in head, and 1,498 in 11.1-RELEASE.
Is there still interest in this? I still think putting those "COMMON ITEMS" in /usr/src/INSTALL would make the information immediately accessible, and obviates the need to prune UPDATING.
There's some really crucial information in that COMMON ITEMS section.