git: fd089bceb3 - main - Avoid the use of "you" in the serialcomms chapter

From: Benedict Reuschling <bcr_at_FreeBSD.org>
Date: Fri, 29 Aug 2025 08:31:50 UTC
The branch main has been updated by bcr:

URL: https://cgit.FreeBSD.org/doc/commit/?id=fd089bceb3f9de4cb77e0a1973759d6dd49d8f2e

commit fd089bceb3f9de4cb77e0a1973759d6dd49d8f2e
Author:     Benedict Reuschling <bcr@FreeBSD.org>
AuthorDate: 2025-08-28 15:53:35 +0000
Commit:     Benedict Reuschling <bcr@FreeBSD.org>
CommitDate: 2025-08-29 08:31:32 +0000

    Avoid the use of "you" in the serialcomms chapter
    
    Rewrite sentences that contain 'you', which should be avoided according
    to the FDP Primer. The resulting sentences are easier to understand and
    often shorter. I did not change programlistings and other output as
    these are from programs, which need to be changed first (out of scope of
    this change).
    
    Event:                  Oslo Hackathon 2025
    Reviewed by:            carlavilla
    Differential Revision:  https://reviews.freebsd.org/D52218
---
 documentation/content/en/books/handbook/serialcomms/_index.adoc | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/documentation/content/en/books/handbook/serialcomms/_index.adoc b/documentation/content/en/books/handbook/serialcomms/_index.adoc
index 18637f7d1c..e275e26ae6 100644
--- a/documentation/content/en/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/en/books/handbook/serialcomms/_index.adoc
@@ -56,14 +56,14 @@ UNIX(R) has always had support for serial communications as the very first UNIX(
 Things have changed a lot from the days when the average terminal consisted of a 10-character-per-second serial printer and a keyboard.
 This chapter covers some of the ways serial communications can be used on FreeBSD.
 
-After reading this chapter, you will know:
+Read this chapter to learn:
 
 * How to connect terminals to a FreeBSD system.
 * How to use a modem to dial out to remote hosts.
 * How to allow remote users to login to a FreeBSD system with a modem.
 * How to boot a FreeBSD system from a serial console.
 
-Before reading this chapter, you should:
+Before reading this chapter:
 
 * Know how to crossref:kernelconfig[kernelconfig, configure and install a custom kernel].
 * Understand crossref:basics[basics, FreeBSD permissions and processes].
@@ -880,7 +880,7 @@ Put in an entry for `tip1200` or `cu1200`, but go ahead and use whatever bps rat
 === Accessing a Number of Hosts Through a Terminal Server
 
 Rather than waiting until connected and typing `CONNECT _host_` each time, use ``tip``'s `cm` capability.
-For example, these entries in [.filename]#/etc/remote# will let you type `tip pain` or `tip muffin` to connect to the hosts `pain` or `muffin`, and `tip deep13` to connect to the terminal server.
+For example, these entries in [.filename]#/etc/remote# allow typing `tip pain` or `tip muffin` to connect to the hosts `pain` or `muffin`, and `tip deep13` to connect to the terminal server.
 
 [.programlisting]
 ....