[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits.
From: |
Stefan Kangas |
Subject: |
Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits. |
Date: |
Sat, 29 Jun 2024 19:08:36 -0700 |
Po Lu <luangruo@yahoo.com> writes:
> Stefan Kangas <stefankangas@gmail.com> writes:
>
>> Our priority is to make our documentation as clear as possible for users
>> of varied skill levels and backgrounds. This sometimes means adding
>> explanations that may seem redundant (or even tautological) to Emacs
>> developers.
>>
>> In particular, we can't assume that readers are familiar with all of our
>> nomenclature, especially not when it's as obscure as "Nextstep means
>> macOS and Gnustep".
>
> The first priority of all documentation is to be accurate and not
> mislead users, as it will if we mention "Nextstep" and "Mac OS" in
> contrast to each other, and they subsequently encounter references to
> Nextstep.
Thanks, but I realized the mistake and updated the text. The new text
was in the paragraph below the ones you quote here.
Please criticize the updated text if you still think that it's
inaccurate, and propose a better wording.