[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#61325: 30.0.50; Jokes in GNUS manual
From: |
Ihor Radchenko |
Subject: |
bug#61325: 30.0.50; Jokes in GNUS manual |
Date: |
Tue, 07 Feb 2023 19:56:12 +0000 |
Pankaj Jangid <pankaj@codeisgreat.org> writes:
>> The paragraph structure is basically:
>>
>> <technical description><joke><half joke, half technical description>
>>
>> Such structure is difficult to understand, especially if the joke itself
>> is not understood.
>
> But you have understood the above structure. Then what is the issue?
The issue is that it took an extra effort to understand it. Not because
of technical details, but simply because of presence of jokes.
IMHO, the primary aim of manuals is explaining technical information to
the users. Jokes that help to understand or at least does not hurt are
totally fine. But when jokes makes the information harder to understand,
isn't it against the aim of writing a good manual?
--
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>
- bug#61325: 30.0.50; Jokes in GNUS manual, (continued)
- bug#61325: 30.0.50; Jokes in GNUS manual, Po Lu, 2023/02/07
- bug#61325: 30.0.50; Jokes in GNUS manual, Ihor Radchenko, 2023/02/07
- bug#61325: 30.0.50; Jokes in GNUS manual, Po Lu, 2023/02/07
- bug#61325: 30.0.50; Jokes in GNUS manual, Ihor Radchenko, 2023/02/08
- bug#61325: 30.0.50; Jokes in GNUS manual, Po Lu, 2023/02/08
- bug#61325: 30.0.50; Jokes in GNUS manual, Ihor Radchenko, 2023/02/08
- bug#61325: 30.0.50; Jokes in GNUS manual, Po Lu, 2023/02/08
- bug#61325: 30.0.50; Jokes in GNUS manual, Eli Zaretskii, 2023/02/08
- bug#61325: 30.0.50; Jokes in GNUS manual, Richard Stallman, 2023/02/08
- bug#61325: 30.0.50; Jokes in GNUS manual, Pankaj Jangid, 2023/02/07
- bug#61325: 30.0.50; Jokes in GNUS manual,
Ihor Radchenko <=
- bug#61325: 30.0.50; Jokes in GNUS manual, Richard Stallman, 2023/02/08
- bug#61325: 30.0.50; Jokes in GNUS manual, dick, 2023/02/07
- bug#61325: 30.0.50; Jokes in GNUS manual, Po Lu, 2023/02/07
- bug#61325: 30.0.50; Jokes in GNUS manual, Eli Zaretskii, 2023/02/07
- bug#61325: 30.0.50; Jokes in GNUS manual, Michael Albinus, 2023/02/08
- bug#61325: 30.0.50; Jokes in GNUS manual, Eli Zaretskii, 2023/02/08
- bug#61325: 30.0.50; Jokes in GNUS manual, Michael Albinus, 2023/02/08
- bug#61325: 30.0.50; Jokes in GNUS manual, Akib Azmain Turja, 2023/02/07
- bug#61325: 30.0.50; Jokes in GNUS manual, Richard Stallman, 2023/02/08
- bug#61325: 30.0.50; Jokes in GNUS manual, Akib Azmain Turja, 2023/02/09