[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: Jean Louis
Subject: Re: Convert README.org to plain text README while installing package
Date: Sun, 12 Jun 2022 14:41:19 +0300
User-agent: Mutt/+ () (2022-05-21)

* Tim Cross <theophilusx@gmail.com> [2022-06-12 06:15]:
> I gues sour differences here are that you have conflated issues of
> readabiity and usability into the definition of plain text.

I did not. I speak of understanding of package descriptions. When user
clicks on a package within Emacs that user expects package
description, not a markup.

It is totally irrelevant for user if markup and tags, properties are
plain text in the context of editors. 

What matters is if user is helped to understand the package
description. Or maybe user is obstructed to understand it.

> Few of the criticisms you have raised IMO are specific to org mode
> or due to org modes syntax.

They are not specific, it just happens that I had in my package list
several Org type package descriptions. If too complex Markdown markup
is used it will also obstruct user to understand package description.

> Many of them are due to the individual author's layout and not the
> result of org mode syntax. You can also write documents which are
> very difficult to read using just plain ASCII. They are both plain
> text.

I do not think that "plain text" is relevant. HTML markup is also
plain text, it is irrelevant in the context of a user reading package
descriptions. User is not supposed to read HTML tags either, right?

> I also think you are over-stating the difficulty of reading the raw org
> file contents. While I would agree they are asier to read when correctly
> formatted, they are not impossible to understand without it.

You may stay in your viewpoint of knowledgable Emacs user, in that
sense there is also no need for package descriptions, then we can
simply tell users to read sources (irony). One has to mentally become
a user who does not know Org, the one who simply wants to find out
what package is about. Only so one can understand it.


Take action in Free Software Foundation campaigns:

In support of Richard M. Stallman

reply via email to

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