[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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

From: Michael Albinus
Subject: Re: Convert README.org to plain text README while installing package
Date: Mon, 06 Jun 2022 18:56:14 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux)

Tim Cross <theophilusx@gmail.com> writes:

Hi Tim,

>> I have no problem if there are structured README.org or README.md files
>> in parallel. But a README file should be plain text.
> I've seen this mentioned multiple times in this thread and it doesn't
> make sense to me.
> Org files *are* plain text. This is one of (perhaps the biggest) selling
> points for org mode. They don't use any form of 'binary' data and can be
> read just fine in any text editor or just using cat/less/more whatever.
> They may look a little *ugly*, especially with respect to URLs, but are
> still quite readable - a lot more readable than other plain text formats
> such as xml or html or json etc.

My point in this discussion is, that package's README files are also
visited by people not using Emacs. I'm confident that Emacs is able to
present an org-mode structure nicely, but this isn't true outside the
Emacs world.

Yes, we're speaking about Emacs packages first-hand. But even they are
distributed outside the Emacs or GitHub/GitLab infrastructure. So we
need a single starting point for users, w/o org-mode dependencies.

Best regards, Michael.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]