GNU bug report logs - #61325
30.0.50; Jokes in GNUS manual

Previous Next

Full log

Message #101 received at 61325 <at> debbugs.gnu.org (full text, mbox):

From: Ihor Radchenko <yantar92 <at> posteo.net>
To: Po Lu <luangruo <at> yahoo.com>
Cc: 61325 <at> debbugs.gnu.org
Subject: Re: bug#61325: 30.0.50; Jokes in GNUS manual
Date: Wed, 08 Feb 2023 11:59:23 +0000

Po Lu <luangruo <at> yahoo.com> writes:

> Ihor Radchenko <yantar92 <at> posteo.net> writes:
>
>> Do you imply that users who did not understand certain parts of manual
>> because of presence of jokes should just try harder instead of asking to
>> clarify of the manual?
>
> Yes, when it is clear to most people that they do not impair the ability
> to understand the manual.

I agree that jokes that do not impair the ability to understand the
manual are ok.

I disagree that jokes in "8 Scoring" and "3.16 Group Topics" do not
impair the understanding. For me, section 8 and section 3.16 are harder
to understand because of jokes. I even missed some of the technical
statements.

A note "3.15 Exiting Gnus" does not impair my understanding. Just make
me feel confused about what it means.

> Many people do not understand English.
> Should we write Emacs documentation in some other language, then?

Please, do not use appeal to ridicule.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.