Re: module documentation draft

[Eli Zaretskii]

> From: Aurélien Aptel <address@hidden>
> Date: Fri, 29 Sep 2017 18:49:59 +0200
> Cc: Philipp Stephani <address@hidden>, Philipp Stephani <address@hidden>, 
>       Emacs development discussions <address@hidden>
> 
> On Fri, Sep 29, 2017 at 6:45 PM, Eli Zaretskii <address@hidden> wrote:
> > I already read this, when this was first announced in April.
> > Unfortunately, the style and the methodology of the description
> > differs significantly from what we use in the ELisp manual.  So this
> > text will have to be reworked, and I didn't yet find time to do it.
> 
> Eli, I believe you're talking about a different document. Philipp's
> documentation is much closer to a specification than a tutorial.
> 
> https://phst.github.io/emacs-modules

No, I'm talking about this very document.

I won't argue with the "tutorial" part, but the point is the style
and the methodology of introducing the features there is very
different from what I expect of a chapter in the ELisp manual.  Just
read some chapter or section which describes a single large feature,
and you will see the difference.

I don't mean to denigrate Philipp's work in any way, I'm just saying
that importing it into the ELisp manual needs some non-trivial work,
that's all.