[Top][All Lists]

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

Re: Why does the tutorial talk about C-n/C-p etc?

From: Marcin Borkowski
Subject: Re: Why does the tutorial talk about C-n/C-p etc?
Date: Fri, 11 Mar 2016 18:34:30 +0100
User-agent: mu4e 0.9.13; emacs

On 2016-03-11, at 17:57, Phillip Lord <address@hidden> wrote:

> Eli Zaretskii <address@hidden> writes:
>> It is a non-trivial decision where to draw the line about what is
>> "common knowledge" and shouldn't be explained.  Once again, the "tax"
>> is a single sentence, so what's the harm?
>> In any case, I suggest to postpone any further arguments until someone
>> actually submits patches to make the tutorial better.  The tutorial
>> should be considered as a whole, not sentence by sentence.  It is
>> currently written from a certain POV that guides most of the text in a
>> consistent way.  You cannot change a sentence here and there without
>> making the text inconsistent.  So a change like the one that I think
>> is proposed will require quite a thorough rewrite, which makes
>> arguments about individual sentences and phrases futile.
> I am working on this. My tutorial is now 480 lines long, so it may need
> some pruning. I have buffers and files to do. My plan is to finish off
> with Emacs packages, but getting users to install a new package from
> My thought is that, at first, this package will contain more tutorial
> information. In the first instance, it will probably just say
> "congratulations", but in later versions, it could take tutorials on
> different topics. It would also enable upgrading the tutorial
> out-of-sync with releases.

Wow, a choose-your-own-adventure tutorial!  Great idea, I really like
it!  I'd be inclined to contribute to it.  I'll check your tutorial

> Phil


Marcin Borkowski
Faculty of Mathematics and Computer Science
Adam Mickiewicz University

reply via email to

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