From nobody Thu Aug 28 16:54:32 2025 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4cCSDS6fvqz66JwR for ; Thu, 28 Aug 2025 16:54:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCSDS694hz3MPQ; Thu, 28 Aug 2025 16:54:32 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400072; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=e1VMnwEzR6lJxHfFxD0EHSamwxL8vWp6bFtOpwOWdKM=; b=ZY3g0umj0qGWOZoUW551xUGKTvinBR6amiUSXY7R5rrosxKw6woYAX5qW1mIyIiOo1mqsb oIGPUz0rZ5lXzUujfO9L6K8IJ+b3Zhvv/LKMjUzmOC3xfQNF4AmfiJSFqbtR1SQj4KmXkY A5+nwOO94vL+jhe6d2XkBR0fgWtP8WnW6dFnGG0HM7PWZFCEaFB8LX/Yhk1sjSke3S1IY0 IdAeNO/dGibeNuw0XYh+O+aAThqUazJBty6a3d1J6E0hPJ6EqCuMYpOgOVGcDcJ7FiqfCK bAv8ziIiNHTx1c3jx4IbI7iXuQmiCPjjXzUsytgHmwsOhliDPjH6HO7jVAfziQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400072; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=e1VMnwEzR6lJxHfFxD0EHSamwxL8vWp6bFtOpwOWdKM=; b=By0ag7WmFGlnmc4vH7MaZCwaNBZVE2RUhEhBzFvqalZPWW30dIu/ykYpCHUO4nWX1d4Rgc kJCzPY9FoBfbEnNe21ZXaWuqJ76BfFIffKUxbQ9+ZqFlDSt5gDDxsiai5xSjTTanFLrFXe AYi3xsn+4g2Y1M3mFLqnfQ+RwmzTFpTeeHlBgxOe59Qp4ja6lraINrRPoGeVvA1PT2SH5Y AONyhCglrRGXuMHqle2zaGE1HGFAJlyP7qObikNze2DJQ8WZCyDsyik3nt5E0e6oi3DecX bGSz6PnSz/eoxXXpxlsWZAwZfmNw/Opuphrc5ERYUZJTtUmEb7oYF5rbNaHiBA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756400072; a=rsa-sha256; cv=none; b=RST8y7PtKthNuc3baWUll4kc0mZXehgnmhkpixKiAw8wjNQ5rQsX8KzYQeBe+Y7BnjR39H 82x5KkfEtbdd8mVRFFqcte5WXTYljxG+JtYge0Mu1L2jSyHWtOhZuV0WKJ9Kj6BrAv9ZHA Ci0AMJKh7tbybSSfo2cGF57/2y9ZVS7y9bH9Ml3U/UiT5rMVxfePjadr5DwGOh4gegkryP gBbJPfj4yse32hp89G/pjXa7tmYka0FbES9pkEnxhxxK64rjb03lTYfmek7jQi6nzkBR+s ygPfu1qbYyT+YnFQNFJU3sQdisVEF8+xWFy2dBU/tdseMKJ5rAZyF33p/4XCXA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4cCSDS5H3yz1H4s; Thu, 28 Aug 2025 16:54:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57SGsWlQ081708; Thu, 28 Aug 2025 16:54:32 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SGsWIN081705; Thu, 28 Aug 2025 16:54:32 GMT (envelope-from git) Date: Thu, 28 Aug 2025 16:54:32 GMT Message-Id: <202508281654.57SGsWIN081705@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: c8ce9da342 - main - Avoid the use of "you" in the Basics chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c8ce9da342741711d263b2b5f0866962e71f3dfe Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=c8ce9da342741711d263b2b5f0866962e71f3dfe commit c8ce9da342741711d263b2b5f0866962e71f3dfe Author: Benedict Reuschling AuthorDate: 2025-08-28 14:36:17 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 16:53:45 +0000 Avoid the use of "you" in the Basics 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/D52205 --- documentation/content/en/books/handbook/basics/_index.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/documentation/content/en/books/handbook/basics/_index.adoc b/documentation/content/en/books/handbook/basics/_index.adoc index df093f4e5e..ad0cdb7a9c 100644 --- a/documentation/content/en/books/handbook/basics/_index.adoc +++ b/documentation/content/en/books/handbook/basics/_index.adoc @@ -56,7 +56,7 @@ This chapter covers the basic commands and functionality of the FreeBSD operatin Much of this material is relevant for any UNIX(R)-like operating system. New FreeBSD users are encouraged to read through this chapter carefully. -After reading this chapter, you will know: +Read this chapter to learn: * How to use and configure virtual consoles. * How to create and manage users and groups on FreeBSD. @@ -559,7 +559,7 @@ How to configure NIS is covered in crossref:network-servers[network-servers,Netw Any user can easily change their password using man:passwd[1]. To prevent accidental or unauthorized changes, this command will prompt for the user's original password before a new password can be set: -.Changing Your Password +.Changing The Password [example] ==== [source,shell] @@ -1257,7 +1257,7 @@ There are some drawbacks to this approach, and one advantage. * FreeBSD's file systems are robust if power is lost. However, a power loss at a critical point could still damage the structure of the file system. By splitting data over multiple file systems it is more likely that the system will still come up, making it easier to restore from backup as necessary. .Benefit of a Single File System -* File systems are a fixed size. If you create a file system when you install FreeBSD and give it a specific size, you may later discover that you need to make the partition bigger. This is not easily accomplished without backing up, recreating the file system with the new size, and then restoring the backed up data. +* File systems are a fixed size. When creating a file system during the FreeBSD installation and giving it a specific size, it may be that one wants to make the partition bigger. This is not easily accomplished without backing up, recreating the file system with the new size, and then restoring the backed up data. + [IMPORTANT] ==== @@ -1291,7 +1291,7 @@ These devices are used by file systems that expect to occupy a slice. Each GPT or BSD partition can contain only one file system, which means that file systems are often described by either their typical mount point in the file system hierarchy, or the name of the partition they are contained in. FreeBSD also uses disk space for _swap space_ to provide _virtual memory_. -This allows your computer to behave as though it has much more memory than it actually does. +This allows the computer to behave as though it has much more memory than it actually does. When FreeBSD runs out of memory, it moves some of the data that is not currently being used to the swap space, and moves it back in (moving something else out) when it needs it. This is called _paging_. @@ -1772,7 +1772,7 @@ For example, to change the shell to `bash`: % chsh -s /usr/local/bin/bash .... -Enter your password at the prompt and press kbd:[Return] to change your shell. +Enter the password at the prompt and press kbd:[Return] to change the shell. Log off and log in again to start using the new shell. [NOTE]