NetBSD-Bugs archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
install/55413: Typos etc. in (amd64) INSTALL files for NetBSD 9.0
>Number: 55413
>Category: install
>Synopsis: Typos etc. in (amd64) INSTALL files for NetBSD 9.0
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: install-manager
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Wed Jun 24 10:55:00 +0000 2020
>Originator: Michael Siegel
>Release: 9.0
>Organization:
>Environment:
>Description:
I've found a few typos etc. in the HTML version of the amd64 INSTALL
file for NetBSD 9.0
(https://ftp.netbsd.org/pub/NetBSD/NetBSD-9.0/amd64/INSTALL.html).
The issues mentioned below very likely concern all four versions of the
amd64 INSTALL file. Some of them probably concern parts common to all
INSTALL files for all architectures. As I'm new to NetBSD and my time is
quite limited, I've decided to leave it to more experienced people to
find out exactly where to solve any of the problems reported here.
I'll go through the file section by section (for the most part).
A)
## Quick install notes for the impatient
* "For third-party programs which are not part of the base NetBSD
distribution, you will want to explore the pkgsrc package management
system, which contains thousands of third party software
applications."
* Should say "third-party software applications" at the end.
* There is one other instance of "third party" needing to be
"third-party" in the "Post installation steps" section.
B)
## What is NetBSD?
In the 1st sentence, I think it should be "open-source" rather than
"Open Source", i.e., lowercase, and hyphenated just like "Unix-like" in
that same sentence because "open-source" is a compound adjective.
C)
## Dedication
In the 2nd sentence of the 2nd paragraph, it should be:
* "long-term contributor" instead of "long term contributor"
* "weird" instead of "weired"
D)
## The NetBSD Foundation
* "?goals and Spirit of the NetBSD Project"
* "Spirit" should not be capitalized here.
E)
## NetBSD/amd64 System Requirements and Supported Devices
It should be "64-bit" instead of "64bit" in the first sentence.
F)
## "Getting the NetBSD System on to Useful Media"
All instances of "USB-stick" should be changed to "USB stick".
G)
## Running the sysinst installation program
* 3. General
* "sysinst is a menu driven program" -> "menu-driven"
* 4. Quick install
* Should say "installation medium" instead of "installation media"
at the end of the 1st paragraph because the user will only use one
medium (i.e., singular) to install NetBSD.
* "What you need" says "An optical drive." However, you don't need
an optical drive if you're installing from a USB stick.
* "The Quick installation"
* Says "USB memstick" at one point. I think it should be kept to
"USB stick" throughout the document in order not cause
unnecessary confusion, especially for non-native speakers of
English.
* "The default values for the path and device should be ok."
* If a bit of nitpicking is allowed, "ok" should either be "OK"
or "okay".
* There are other occurrences of that in the document.
* 5. Booting NetBSD
* "The boot loader will start, which will print a countdown and
begin booting."
* That sentence sounds a bit weird.
* 6. Network configuration
* "If you do not intend to use networking during the installation,
but you do want your machine to be configured for networking once
it is installed?"
* Should rather say "once NetBSD" or "once the system is
installed".
* 14. Installation using FTP
* All occurrences of "ftp" should be changed to "FTP".
>How-To-Repeat:
>Fix:
Modify the respective source files.
Home |
Main Index |
Thread Index |
Old Index