Re: Morally equivalent

[Michael Heerdegen]

Christopher Dimech <dimech@gmx.com> writes:

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

Sounds excellent in theory.  In reality lots of people are not good at
writing good documentation.  Or don't want to.  Or hate it.
Although everybody knows that they _should_ do exactly what you
describe.  The problem is not that they don't know.

> The documentation is getting longer and longer.

IME the documentation gets longer approx. in the same rate that Emacs
grows.  And it still does grow.  Selective reading is not prohibited, as
is selective familiarization with Emacs.  Documentation is also quite
good, on average, and also partly redundant, so you even have the luxury
to choose between several paths.  The hard part in mastering Emacs is
Emacs, not its documentation.  People do it nonetheless because it's
worth it.  Others don't because it's not worth it for them.

Michael.