[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: module documentation draft

From: Eli Zaretskii
Subject: Re: module documentation draft
Date: Fri, 29 Sep 2017 21:08:10 +0300

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

reply via email to

[Prev in Thread] Current Thread [Next in Thread]