Re: Communication problems and possible problems with the website

[c.buhtz@posteo.jp]

Am 25.02.2022 13:30 schrieb Ihor Radchenko:
> If you think that the current wording is confusing, please point out
> which parts. We are pretty much blind here on the potential issues for
> the newcomers (for obvious reason - we are too familiar with Org).
> Pointing to the confusing parts would help a lot.

The text in the buffer after M-x org-submit-bugreport says in the first 
line "You are about to submit a bug report to the Org mailing list".
This does not explain how this is done. As a (very fresh not Emacs 
familiar) user I wouldn't assume that I have to setup my Emacs as a mail 
client in that case. I would assume that there is some magic in behind. 
;)

Just write something like "Make sure your Emacs is setup to send emails 
or copy and paste the resulting buffer into an Email client of your 
choice."

>> 5.
>> 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.
> 
> This is confusing. If you go to orgmode.org, the git link is in the 
> front
> page. Also, orgmode.org -> Install will bring you to the relevant page
> of the manual, which provides all possible installation options
> including cloning the official git repo.

But the front-page and the Install are not the place where I would 
expect infos like that. Repos are for contributers not for users.
Users are reading "Install" and sometimes the front-page. I have not 
read the front-page but clicked on contribute.
In contribute the git thing is explained in "Details on how to submit 
patches" but there is a repo url missing.

> Similarly, https://orgmode.org/worg/ has the links to its code in the
> first heading:
> 
>>> Worg documentation on your machine
>>> git clone https://git.sr.ht/~bzg/worg

Definitly my fault.

btw: I would suggest to create links or mirror repos on your GitHub 
page.

> Do you recall the urls where you tried to search for the source code?

I searched behind the GitHub link (right top corner of the website) 
first.
I searched around on savannah but still have problems with the 
interface; which is another topic.

The point is that the users have to search (e.g. DuckDuckGo) because the 
links to the repo or to description that there is no public repo are not 
at the usual (compared to most of the other FOSS projects) places.