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