sxemacs-devel
[Top] [All Lists]

The fscking manuals (again)

From: "Johann [Myrkraverk] Oskarsson" <johann@xxxxxxxxxxxxxx>
Subject: The fscking manuals (again)
Date: Sun, 22 Aug 2004 19:20:06 +0000
Hi,

I suddenly got aware of gutters in XEmacs, and got a bit excited, so I
started to read the docs.

So I fired up info, looked at the lispref, and started to read.  So
far ok, the intro is ... an intro, it works, but it's written in a
rather boring style.

n

And this is where it hit me.  Again.  API all over the place.  Plain
boring doc strings, rather than exciting sexy explanations.  And not
very helpful for newbies (with gutters) at all.

So can we please make it a goal to rewrite the docs, with some more
sexy contents?


Have fun,

Johann

P.S. Documentation is like sex, when it's bad it's better than
nothing, when it's good, it's great.  (from fortune, I think).


<Prev in Thread] Current Thread [Next in Thread>