Re: Morally equivalent

[Christopher Dimech <dimech@gmx.com>]

> Sent: Monday, October 17, 2022 at 12:10 PM
> From: "Michael Heerdegen" <michael_heerdegen@web.de>
> To: "Christopher Dimech" <dimech@gmx.com>
> Cc: help-gnu-emacs@gnu.org
> Subject: Re: Morally equivalent
>
> Christopher Dimech <dimech@gmx.com> writes:
>
> > When people start wondering whether something is a technical term,
> > then it is a
> > big problem.  Stefan like all of us, should learn from his mistakes.
>
> I think the bigger problem, rather than Stefan's ability to learn from
> mistakes, is to find people actually trying to improve the
> documentation.

Right.  But I would say that the easiest thing is to write better documentation
(in source) as you are writing the code.  At least that part should be good.
The source documentation is the biggest strength of this system.

> It's easy to find things that are not perfect.  If you want to help,
> search for bug reports about documentation and work on them.  It's not
> more fun for Stefan than for anyone else.  Discussing that things are
> not perfect is trivial - that's clear to _all_ of us.  All of us know
> that.  We need more people to do the work, not people to remind and
> discuss that there is work to do.
>
> Michael.

The documentation is getting longer and longer.  And many people do not have time
for that.  They require shortcuts.  From my experience, besides maintainers there
should be designers.  So that in future, people would require less knowledge rather
than more, to achieve a task.  Competent designers almost don't exist, this has
always been the case.  Look at the documentation for latex, always gets worse as time
goes by.