Re: Communication problems and possible problems with the website

[Ihor Radchenko]

c.buhtz@posteo.jp writes:

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

Thanks! This makes sense. We should probably modify
org-submit-bug-report docstring, the prompts, and the email template.

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

Fair point. We need someone to make a patch for
https://orgmode.org/worg/org-contribute.html Probably adding the git
repo links to Org mode, WORG, and the orgmode.org website:
git clone git://git.sv.gnu.org/emacs/org-mode.git
git clone https://git.sr.ht/~bzg/worg
git clone https://git.sr.ht/~bzg/orgweb

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

Org has no official GitHub page. This is partially a requirement from
Free Software Foundation:
https://www.gnu.org/prep/standards/standards.html#References

I think that we might create some kind of mirror given that it is only
used as means to redirect users to this mailing list, but we will need
(1) have a volunteer ready to accept github legal terms and take care
about the mirror; (2) consult FSF. I would like to hear opinions from
other contributors on this idea.

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

I understand your concern. We may probably add a link to "Contribute"
page as a "git" image in the top right corner. (and maybe rename
"Contribute" to "Feedback"). Alternative suggestions are also welcome. I
will let Timothy/Bastien decide on this.

Also, for some context (I do not imply that we should not update the
website to make it more familiar to users).

Org mode was

>> Created by Carsten Dominik in 2003, maintained by Bastien Guerry and
>> developed by many others.

while Github was

>>  Launched    April 10, 2008; 13 years ago

:P

Best,
Ihor