Re: Convert README.org to plain text README while installing package

[Stefan Kangas]

Alan Mackenzie <acm@muc.de> writes:

> We're talking about READMEs here.  They're
> typically 20 to 100 lines long.  A text file is ideal for these.

A text file is fine of course, but they lack useful features such as
including images (e.g. screenshots).  You would need some markup for
that, and Org-mode happens to have solid built-in support.

> > Texinfo has its strengths of course, but it is unfortunately perceived
> > as arcane and hard to use by many.
>
> It's moderately easy to use, somewhat difficult to learn.

Agreed.

> > And Org-mode can be converted to be read in 'M-x info'.
>
> You mean it _has_ to be converted to be read?

I don't think so, no.  I'm just saying that you can do what we do with
the org manual, so you get to write Org-mode, but still get to read in
'M-x info'.