[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: |
Sun, 05 Jun 2022 13:15:10 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) |
Tassilo Horn <tsdh@gnu.org> writes:
Hi Tassilo,
>>>> I disagree entirely with you. Org mode is highly complicated,
>>>> obscure (I've never managed to get a feel for what it does), and
>>>> difficult to learn (I've never managed it). A text file is far
>>>> easier to read for those not familiar with org. We're talking about
>>>> READMEs here. They're typically 20 to 100 lines long. A text file
>>>> is ideal for these.
>>>
>>> 1+. README is a text file which is consulted in order to get
>>> information about the related software. There's no rule to visit it
>>> by Emacs only.
>
> People nowadays write README.org and README.md files instead of
> plain-text READMEs because the packages' repositories are hosted on some
> forge (sr.ht, github, gitlab, gitea, whatever) which supports rendering
> those formats in a nice way. So the choice of format is natural for
> package authors. And they frequently contain markup like headings,
> bullet lists, bold, italics, and code snippets which simply look much
> better than their text-only alternative (even in their
> editing/non-rendered versions).
Not everybody uses Github/Gitlab/<you name it> infrastructure
exclusively. There are dinosaurs like me, who simply inspect tarballs
and alike.
I have no problem if there are structured README.org or README.md files
in parallel. But a README file should be plain text.
> Bye,
> Tassilo
Best regards, Michael.
- Re: Convert README.org to plain text README while installing package, (continued)
- Re: Convert README.org to plain text README while installing package, Tassilo Horn, 2022/06/04
- Re: Convert README.org to plain text README while installing package, Alan Mackenzie, 2022/06/04
- Re: Convert README.org to plain text README while installing package, Stefan Kangas, 2022/06/04
- Re: Convert README.org to plain text README while installing package, Alan Mackenzie, 2022/06/04
- Re: Convert README.org to plain text README while installing package, Stefan Kangas, 2022/06/04
- Re: Convert README.org to plain text README while installing package, Michael Albinus, 2022/06/05
- Re: Convert README.org to plain text README while installing package, Po Lu, 2022/06/05
- Re: Convert README.org to plain text README while installing package, Tassilo Horn, 2022/06/05
- Re: Convert README.org to plain text README while installing package,
Michael Albinus <=
- RE: [External] : Re: Convert README.org to plain text README while installing package, Drew Adams, 2022/06/05
- Re: Convert README.org to plain text README while installing package, Tim Cross, 2022/06/05
- Re: Convert README.org to plain text README while installing package, Philip Kaludercic, 2022/06/06
- Re: Convert README.org to plain text README while installing package, Tim Cross, 2022/06/06
- Re: Convert README.org to plain text README while installing package, Philip Kaludercic, 2022/06/06
- Re: Convert README.org to plain text README while installing package, Alan Mackenzie, 2022/06/06
- Re: Convert README.org to plain text README while installing package, Akib Azmain Turja, 2022/06/06
- Re: Convert README.org to plain text README while installing package, Tim Cross, 2022/06/06
- Re: Convert README.org to plain text README while installing package, Eli Zaretskii, 2022/06/06
- Re: Convert README.org to plain text README while installing package, Tim Cross, 2022/06/07