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: David Kastrup
Subject: Re: On being web-friendly and why info must die
Date: Tue, 09 Dec 2014 03:18:54 +0100
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux)

Lars Magne Ingebrigtsen <address@hidden> writes:

> David Kastrup <address@hidden> writes:
>
>> How does it not scale?  Do you think Eli will spend more time and effort
>> on your manual entries than you, and when you write twice the amount,
>> he'll have to invest more than twice the work?
>>
>> What does "doesn't scale" mean in this context?
>
> Well, as incredibly as it sounds, Eli is (presumably) just one person,
> while the number of people who are not Eli is a whole lot bigger than
> 1.
>
> So having Eli do all the markup for everybody who is not Eli doesn't
> really scale well.

So far, it scales perfectly well.  Because all of those people for whom
Texinfo is the hurdle keeping them from writing documentation find
themselves a different reason.  Not wanting to overwork Eli is one of
the more ridiculous ones since it does not appear that he actually had
to spend more than an hour of his life so far putting Texinfo markup
into batches of new documentation.

> It would be better if everybody could do the markup themselves.

Yeah, it's too sad, all of those pages of finished documentation people
have lying around that are just missing the Texinfo markup because
nobody would want to overwork Eli or anybody else on the list.

Get real.  Texinfo is not the excuse for not finishing documentation
work, it is the excuse for not even starting it.  Get rid of Texinfo,
and people will find another excuse.

-- 
David Kastrup




reply via email to

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