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
I've found a few typos etc. in the HTML version of the amd64 INSTALL
file for NetBSD 9.0

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).

## 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 

    * 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.

## 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.

## Dedication

In the 2nd sentence of the 2nd paragraph, it should be:

  * "long-term contributor" instead of "long term contributor"

  * "weird" instead of "weired"

## The NetBSD Foundation

  * "?goals and Spirit of the NetBSD Project"

    * "Spirit" should not be capitalized here.

## NetBSD/amd64 System Requirements and Supported Devices

It should be "64-bit" instead of "64bit" in the first sentence.

## "Getting the NetBSD System on to Useful Media"

All instances of "USB-stick" should be changed to "USB stick".

## 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 

      * "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 

  * 14. Installation using FTP

    * All occurrences of "ftp" should be changed to "FTP".

Modify the respective source files.

Home | Main Index | Thread Index | Old Index