emacs-devel
[Top][All Lists]
Advanced

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

Re: [PATCH] Removed unnecessary text in TUTORIAL and made some changes


From: Eli Zaretskii
Subject: Re: [PATCH] Removed unnecessary text in TUTORIAL and made some changes
Date: Sat, 22 Apr 2023 14:50:32 +0300

> From: Shynur Xie <one.last.kiss@outlook.com>
> CC: "emacs-devel@gnu.org" <emacs-devel@gnu.org>
> Date: Sat, 22 Apr 2023 11:31:33 +0000
> 
> > They are basically minor stylistic changes, or removal of text which
> > I think is useful, and in general in line with the overall style of
> > the tutorial.
> 
> My primary goals with these modifications are:
> 
> - To make the documentation more concise and less verbose.
> 
> - To combat the growth in length of Emacs documentation, as it seems
>   that most Emacs documentation files only ever get larger and never
>   smaller.  I'm not sure if there's a need for concern - it may be
>   more difficult for (new) users to get into the right mindset by
>   reading documentation.

The tutorial doesn't really grow, not significantly.  And making it
shorter by assuming readers don't need some detailed descriptions goes
against the tutorial's purpose.

> However, these are just subjective opinions; you may reject them, of
> course.

Like I said: I've reviewed all the changes you propose, and I don't
think we should make those changes.

Thanks.



reply via email to

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