Re: Communication problems and possible problems with the website

From: Russell Adams <RLAdams@adamsinfoserv.com>
To: emacs-orgmode@gnu.org
Subject: Re: Communication problems and possible problems with the website
Date: Fri, 25 Feb 2022 13:25:41 +0100	[thread overview]
Message-ID: <YhjKxd7EDTLR+SgA@tahm.private> (raw)
In-Reply-To: <0472f849f3ae42df68b0f031d61594d9@posteo.de>

Just to start, honest critical feedback is just fine. Thank you for
not being negative. ;]

On Fri, Feb 25, 2022 at 11:29:38AM +0000, c.buhtz@posteo.jp wrote:
> This website has a lot of deadlinks.
> https://orgmode.org/worg/exporters/ox-overview.html

Worg is community written and maintained. I've personally done
deadlock scans before, but I'm sure it needs to be done again.

Care to volunteer?

> This website
> https://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.html
> at the end in sub-section "Further reading" points to the mailinglist
> but only to the archive
> (http://lists.gnu.org/archive/html/emacs-orgmode/) not to the
> list-subscription site
> (https://lists.gnu.org/mailman/listinfo/emacs-orgmode).
> And on the archive site there is no link to the subscription site.

Reading implies reading the list archive, not posting.

It's unfortunate that the archive doesn't link back to the main
list. I'm not sure that's configurable.

I've fixed it so that it links to the Worg page about the mailing
list. I hope that increases the clarity.

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

> Search more around I found out that I have to submit bugreports from
> inside Emacs via M-x org-something....
> Make clear that I have to setup Emacs for sending emails in that case.
> In my case I am not able to submit regular bug-reports because I do not
> manipulate my headers and my Emacs is not setup for emails.

M-x org-submit-bug-report

Emacs doesn't have to be setup for email, you can simply copy the
message into your mail client to send. It tells you that inside Emacs
when you create the report.

This is the same as M-x submit-emacs-bug.

Again the first point under Orgmode.org's Contribute button is bug
reporting.

> 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. Suggesting edits
for that site is certainly appropriate on this mailing list.

https://orgmode.org/worg/ is community written, and the git repository
is on the main page of both orgmode.org and Worg:
https://git.sr.ht/~bzg/worg

You can follow the directions below to request access to contribute to
Worg:

https://orgmode.org/worg/worg-about.html

------------------------------------------------------------------
Russell Adams                            RLAdams@AdamsInfoServ.com

PGP Key ID:     0x1160DCB3           http://www.adamsinfoserv.com/

Fingerprint:    1723 D8CA 4280 1EC9 557F  66E8 1154 E018 1160 DCB3