Re: Improving documentation of Org Mode integration into Emacs.

[Michael Albinus <michael.albinus@gmx.de>]

Karl Fogel <kfogel@red-bean.com> writes:

Hi Karl,

> * In admin/MAINTAINERS, I did not list   "test/lisp/org/org-tests.el"
>   as a   file maintained by the Org Mode project, because it looks
>   like   that file exists only in Emacs and is not shipped with Org
>   Mode.

That's OK. Org-mode has a lot of own test files not integrated into
Emacs repo; I hope we can get them too.

> +So when you are making a contribution -- such as fixing a bug or
> +proposing an enhancement -- to one of these externally maintained
> +packages, you often need to deal with that package at its upstream
> +source.

I'm not sure that this is always the case. For Tramp, I'm happy if
people refer to the Emacs repo files; sync with the upstream package is
something contributors don't need to worry about. We shall keep the
barrier low.

More important are compatibility restrictions. All of these externally
maintained packages have their policy, we shall advice potential
contributors to respect them. Refer to the respective Package-Requires:
header line.

> +Org Mode
> +	Home Page: https://orgmode.org/
> +	Maintainer: Org Mode developers

The sync between org-mode and Emacs is performed by Kyle Meyer
<kyle@kyleam.com>, shall we mention him as the guy to be contacted in
case of?

> Best regards,
> -Karl

Best regards, Michael.