From: Po Lu <luangruo@yahoo.com>
To: Stefan Kangas <stefankangas@gmail.com>
Cc: emacs-devel@gnu.org
Subject: Re: emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits.
Date: Sun, 30 Jun 2024 10:03:33 +0800 [thread overview]
Message-ID: <871q4ffaq2.fsf@yahoo.com> (raw)
In-Reply-To: <CADwFkm=aKBbvSEyS94sC9Rqc2Q5Ez7t9qGJHbOjcmLSxU6kUmA@mail.gmail.com> (Stefan Kangas's message of "Sat, 29 Jun 2024 18:57:54 -0700")
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.
next prev parent reply other threads:[~2024-06-30 2:03 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <171967386705.12704.7103897810618296421@vcs2.savannah.gnu.org>
[not found] ` <20240629151113.6A350C1FB74@vcs2.savannah.gnu.org>
2024-06-29 15:17 ` emacs-30 d063af203c8 7/8: Add "New in Emacs 30" to FAQ Stefan Kangas
[not found] ` <20240629151110.D1321C1FB5B@vcs2.savannah.gnu.org>
2024-06-30 1:21 ` emacs-30 22af3a71039 3/8: ; * etc/NEWS: More copy-edits Po Lu
2024-06-30 1:57 ` Stefan Kangas
2024-06-30 2:03 ` Po Lu [this message]
2024-06-30 2:08 ` Stefan Kangas
2024-06-30 2:15 ` Po Lu
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=871q4ffaq2.fsf@yahoo.com \
--to=luangruo@yahoo.com \
--cc=emacs-devel@gnu.org \
--cc=stefankangas@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).