emacs-devel
[Top][All Lists]
Advanced

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

Re: On being web-friendly and why info must die


From: Eli Zaretskii
Subject: Re: On being web-friendly and why info must die
Date: Fri, 05 Dec 2014 22:00:16 +0200

> Date: Fri, 5 Dec 2014 12:55:04 -0500
> From: "Eric S. Raymond" <address@hidden>
> Cc: address@hidden
> 
> Eli Zaretskii <address@hidden>:
> > Until more people start contributing to the docs, it makes very little
> > sense to me to change the tools, and by that cut the branch on which
> > we sit, documentation-wise.
> 
> You have this exactly backwards.  Texinfo/info are a barrier that impedes
> more recruitment of hands to work on documentation.  This is one of the
> reasons they must die.

I think you are wrong.  Texinfo is almost plain text, so writing
documentation in it is not hard, certainly not a barrier.  OTOH, the
lack of motivation among code developers to write documentation, which
leads to lack of know-how about writing good documentation, is a well
known fact.



reply via email to

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