Re: Communication problems and possible problems with the website

[c . buhtz]

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
> > 2.
>
> 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.

Kind
Christian