[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Communication problems and possible problems with the website

From: c . buhtz
Subject: Re: Communication problems and possible problems with the website
Date: Fri, 25 Feb 2022 12:38:24 +0000

Dear Russell,

thank your for the explanations and taking my issues into account.

Am 25.02.2022 13:25 schrieb Russell Adams:
On Fri, Feb 25, 2022 at 11:29:38AM +0000, c.buhtz@posteo.jp wrote:
This site does not make clear how to submit bug reports. It even does
not make clear that the "way" is unusual (not web-based bug-trackers
like bugreport or github). It simply says "Submit a bug report" but does
not how. I think the important point and information for the users is
that "Bug reports are done via E-Mail" to the mailinglist with
manipulating the headers or using Emacs itself.

Where would this belong? On the main Org page? On Worg? It's
documented under "feedback" in the manual.

All Emacs bug reports are to mailing lists. That is the usual.

On the main org-mode site the first major point under "Contribute" is
how to submit a bug report.

I was looking here: https://orgmode.org/worg/org-contribute.html
Especially the section "Ways to contribute" -> "Ways that do not involve programming" -> "Send bug reports"
There is not described _how_ to do this. That is the point.

The first sentence links to how to produce "usefull feedback". Yes your are right to say, that behind that link is the M-x org-submit-bug-report described. But org-submit-bug-report is about a bug-report and not about feedback. Feedback is not a bug-report. Maybe it is the simplest to write "Submit bugs to the mailing list." And maybe give some more details about the manipulated header and if I have to subscribe to the list first to submit a bugreport.

What I meant with "unusual" is that in the broader context of FOSS it is unusual to do bug reports via M-x ...
By the way I wasn't aware that Emacs itself implements this way, too.

It is unclear where the repositories for the source code and the code of the website are. If I had found them I would have created a PR/patch for

Which site?

https://orgmode.org/ is administered by Org maintainers. I'm not sure
where that repo is, and it's not publicly writable.

From my point of view this is unusual to. But this just should made clear to the users. I wasted time searching the repo. Just write "The repo is not publicly available". ;)
Because orgmode is FOSS everyone (new to it) would expect a source repo.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]