From nobody Thu Aug 28 17:05:58 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 4cCSTf4pygz66KYn for ; Thu, 28 Aug 2025 17:05:58 +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 4cCSTf48m8z3NQQ; Thu, 28 Aug 2025 17:05:58 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400758; 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=tHXoJv+T+R+Sv/GfExzEuEoiL+/+Z7rsgyastBXF088=; b=t9Lzm7XY1/kBLtJh5jW+rtqYKIwtDN8GlriRgq+dxc/fUHU8K4HXWPlwMV6vzKrffynbDI hIJ9vMYSgjLe+NHvEMSIVwUmScpm7M0vT6nC22WJWBMhvuvZXoiQ4eSnWTqtzW8+uv3wJt Vof8+hMcyJibK8EXEMIWLzyKU28cu/3CsUTen/zVqIYYBuu3aLfXnaUAnoWWuKQwZtkvp+ sPEL1J6SKZvCpmP2TEbqKrtxC+JLCI1/7oxTA3WlGONN5NEe+VGx72R9A2Aqrt7ebhMQ8r 8FvmnxwBrgIjPXybee3f/SbMPbbBtjGO8e4IxCIkTNlZM7RjmH1Gyp2m7I9RXw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400758; 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=tHXoJv+T+R+Sv/GfExzEuEoiL+/+Z7rsgyastBXF088=; b=xTk/M3B8JA73T7peNntCcRgiJkBa1qxf0UbR1k/MbU4e528IyxAYZCzGkgWk5jqom5ToGm 1GYui3Cw9/9fRJfVcuovSTaJlutpiGrNE2wzH73NwWjJH1pFr+8zNIynC2it9QfPGy/mga MdnDTBsFT7JpsmUKe3SoVNPjVzX6Jx6jJWR2NbekKY81yeXA66ypYndEzzD4Uu8MAB8zyH ybLsD+Bwz4iIoQ1AGSEUixMqmJ8ziVJpe6BraeKwCx/IrDEtbrWjXSj2DpvI1DvCG8GiA6 pDR13Ri78BBwUMX3VCIEbmXALk+og+8EkW/y+Gj2MWeTbREWvUb3lkxwyeA7xA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756400758; a=rsa-sha256; cv=none; b=VDM/700WFT/vYmnfPulMuVv0G/AD6KU3rxbQls/8k5jxy5yMjPaYABystTK1LJcDTGmQaE xwO0gFcvJf++nZvq60ps5sIBmTYV2Rlk7OUlkZPmv45hZqkxr+gMByp2yr57I2BjD39iG1 cn8hmOqYeqxrqSt/3mtbTnTi4Kbqr0Au9PHdFLcLVL8vTM+w2DaFZui3Tj/O2AG/Ll4sDX wD7ajF5PDuUKVR8DpUTL9JasYpBJHrSZIbUGmgP6kQbG2ler20h4y/XKuWitTLLFbrOlCQ /P2gOug5bPKqQbYVMq+gveBOWEZEb26/UEI+J+lnO/0rY6kKUpmrOnbNueGR9Q== 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 4cCSTf3llpz1Gvg; Thu, 28 Aug 2025 17:05:58 +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 57SH5wHP002079; Thu, 28 Aug 2025 17:05:58 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SH5wq5002076; Thu, 28 Aug 2025 17:05:58 GMT (envelope-from git) Date: Thu, 28 Aug 2025 17:05:58 GMT Message-Id: <202508281705.57SH5wq5002076@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 050c08320a - main - Avoid the use of "you" in the mail 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: 050c08320aa7826f8e6250cd4d93cbf9b38d4c57 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=050c08320aa7826f8e6250cd4d93cbf9b38d4c57 commit 050c08320aa7826f8e6250cd4d93cbf9b38d4c57 Author: Benedict Reuschling AuthorDate: 2025-08-28 15:19:12 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 17:05:30 +0000 Avoid the use of "you" in the mail 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/D52211 --- documentation/content/en/books/handbook/mail/_index.adoc | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/documentation/content/en/books/handbook/mail/_index.adoc b/documentation/content/en/books/handbook/mail/_index.adoc index c8c3cb076a..003b5a429c 100644 --- a/documentation/content/en/books/handbook/mail/_index.adoc +++ b/documentation/content/en/books/handbook/mail/_index.adoc @@ -141,10 +141,8 @@ username@gmail.com|smtp.gmail.com:password [NOTE] ==== -If you have 2-factor authentication enabled, you will need to generate an -application-specific password as your normal login password will be -rejected. See Google documentation for more information on -https://myaccount.google.com/apppasswords[app-specific passwords]. +With enabled 2-factor authentication a generated application-specific password as the normal login password will be rejected. +See Google documentation for more information on https://myaccount.google.com/apppasswords[app-specific passwords]. ==== Execute the following command to test the configuration: @@ -384,7 +382,7 @@ daily_submit_queuerun="NO" The next step is to install another MTA, man:dma[8] will be used in this example. As pointed above, man:dma[8] is the default MTA in FreeBSD starting with version 14.0. -Therefore, it is only necessary to install it from the ports if you are using a previous version. +Therefore, it is only necessary to install it from the ports when using a previous version. To install it execute the following command: @@ -767,7 +765,7 @@ example.FreeBSD.org has address 204.216.27.XX example.FreeBSD.org mail is handled (pri=10) by nevdull.FreeBSD.org .... -All mail sent to `example.FreeBSD.org` will be collected on `nevdull` under the same username instead of being sent directly to your host. +All mail sent to `example.FreeBSD.org` will be collected on `nevdull` under the same username instead of being sent directly to the local host. The above information is handled by the DNS server. The DNS record that carries mail routing information is the link:https://en.wikipedia.org/wiki/MX_record[mail exchanger record (MX record)]. @@ -788,7 +786,7 @@ The lowest MX number is the host that receives mail directly, if available. If it is not accessible for some reason, the next lower-numbered host will accept messages temporarily, and pass it along when a lower-numbered host becomes available. Alternate MX sites should have separate Internet connections in order to be most useful. -Your ISP can provide this service. +The ISP can provide this service. [[mail-domain]] === Mail for a Domain