From: Kyle Meyer <kyle@kyleam.com>
To: Mike Kupfer <mkupfer@alum.berkeley.edu>
Cc: 52399@debbugs.gnu.org
Subject: bug#52399: 28.0.60; easier access to ORG-NEWS
Date: Thu, 09 Dec 2021 20:43:16 -0500 [thread overview]
Message-ID: <87a6h9fd57.fsf@kyleam.com> (raw)
In-Reply-To: <17858.1639097986@alto>
Mike Kupfer writes:
> Finding ORG-NEWS seems harder than it should be.
>
> 1. The "Browse Org News" menu item (Org > Documentation > Browse Org
> News) isn't adequate, because it takes you to orgmode.org. The package
> description (C-h P org RET) has the same problem. If you're working
> offline, orgmode.org is not going to be available. Also, it shows the
> news for the latest release, which might not be what you have installed.
> (The news for older releases is available at the bottom of the page, but
> it could be confusing if you don't notice that the news that is first
> presented is for a different release.)
>
> 2. I don't see a reference to ORG-NEWS in the Org mode section of the
> Info pages, much less an easy way to get to it.
These two look like something that would be dealt with on Org's side.
This report has been reassigned there, so perhaps someone on the Org
list will have thoughts or decide to work on a patch.
> 3. The entry in NEWS for the Org mode update mentions ORG-NEWS, but it
> doesn't say how to get to it. (Yes, I know how to get to ORG-NEWS from
> NEWS. Do we expect random users to understand the layout of an
> installed Emacs at that level of detail?)
And I guess this one is for Emacs's side at the time of the sync.
I was looking through the NEWS* files in the Emacs repo for guidance
from other packages, but I see mostly the same thing ("GNUS-NEWS",
"MH-E-NEWS", "ERC-NEWS", ...). I guess there is one that's a little
different, though I'm not sure how helpful tacking on "./" is: "See the
file ./MH-E-NEWS for details".
Do you have any suggestions for what would be more helpful to put there?
next parent reply other threads:[~2021-12-10 1:45 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <17858.1639097986@alto>
2021-12-10 1:43 ` Kyle Meyer [this message]
2021-12-10 7:12 ` bug#52399: 28.0.60; easier access to ORG-NEWS Kévin Le Gouguec
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.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87a6h9fd57.fsf@kyleam.com \
--to=kyle@kyleam.com \
--cc=52399@debbugs.gnu.org \
--cc=mkupfer@alum.berkeley.edu \
/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/org-mode.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).