Bug 264892 - FreeBSD Handbook: One-time Passwords: grammar
Summary: FreeBSD Handbook: One-time Passwords: grammar
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Ceri Davies
URL: https://github.com/freebsd/freebsd-do...
Keywords:
Depends on:
Blocks: handbook-2022
  Show dependency treegraph
 
Reported: 2022-06-25 22:56 UTC by kodcode
Modified: 2023-01-01 17:08 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description kodcode 2022-06-25 22:56:35 UTC
14.3.3

>> The OPIE prompts provides a useful feature.

Instead:

The OPIE prompt provides a useful feature.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2022-06-26 19:25:06 UTC
(In reply to kodcode from comment #0)

Beginning at <https://docs.freebsd.org/en/books/handbook/security/#one-time-passwords> (currently 14.3) …

If I understand correctly: OPIE is, or can be, a series of prompts; plural. 

So, instead, maybe: 

> The OPIE prompts provide a useful feature.

Although honestly, it's the type of sentence that I'd simply remove. 

(Like, everything in a handbook is, or should be, implicitly useful.)
Comment 2 kodcode 2022-06-26 19:43:41 UTC
(In reply to Graham Perrin from comment #1)

Thanks.

In order to limit the number of changes in that paragraph, I would stick with "The OPIE prompt provides...".

As a complete newbie, spending a fair amount of time reading handbooks, I do appreciate the "relaxed" writing style in the FreeBSD handbook. 

True, if you use it merely as a reference book, such sentences have low or no value.
Comment 3 Ceri Davies freebsd_committer freebsd_triage 2023-01-01 17:08:51 UTC
Fixed, thanks for the report.
Comment 4 commit-hook freebsd_committer freebsd_triage 2023-01-01 17:08:52 UTC
A commit in branch main references this bug:

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

commit 3dcea0ed1f31d2d73f55182053a984fe6a56e871
Author:     Ceri Davies <ceri@FreeBSD.org>
AuthorDate: 2023-01-01 17:07:24 +0000
Commit:     Ceri Davies <ceri@FreeBSD.org>
CommitDate: 2023-01-01 17:07:24 +0000

    handbook/security: minor grammatical nit
    PR:             264892
    Reported by:    kodcode@gmx.com

 documentation/content/en/books/handbook/security/_index.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)