Re: Comments on Summary section of Org manual (was: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable)

2024-01-05 Thread Ihor Radchenko
Matt writes: > On Wed, 03 Jan 2024 14:41:29 +0100 Ihor Radchenko wrote --- > > > I do not see much benefit changing "todo list" to "to-do list". Both are > > clear and both are grammatically correct. > > I said "TODO" to "to-do". I was reacting to it being all caps. I'm sorry I >

Re: Comments on Summary section of Org manual (was: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable)

2024-01-03 Thread Matt
On Wed, 03 Jan 2024 14:41:29 +0100 Ihor Radchenko wrote --- > I do not see much benefit changing "todo list" to "to-do list". Both are > clear and both are grammatically correct. I said "TODO" to "to-do". I was reacting to it being all caps. I'm sorry I didn't say that. When

Comments on Summary section of Org manual (was: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable)

2024-01-03 Thread Ihor Radchenko
Matt writes: > Several things in the first paragraph unrelated to your changes stick > out to me. I can't help but make some other remarks. > > "TODO" should probably be "to-do". Every dictionary I looked in has > an entry for "to-do". I think that's the common spelling. Yet, we consistently

Re: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable

2024-01-03 Thread Ihor Radchenko
Jean Louis writes: > In my opinion, it's not that Org was intentionally designed to be > "lightweight markup readable for humans"; rather, it was maintained in > a manner that focused on preserving its readability and prevented it > from evolving into something less comprehensible. The point of

Re: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable

2024-01-03 Thread Bastien Guerry
Jean Louis writes: > It's primary use was for Emacs users to make notes, TODO tasks, > etc. It is secondary that it became leightweight markup language that > can export to various documents. IMHO it has always been a _lightweight markup language_, used for notes and TODO tasks, then soon

Re: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable

2024-01-03 Thread Jean Louis
* Thomas S. Dye [2024-01-02 08:39]: > Aloha Ihor, > > Ihor Radchenko writes: > > > @@ -22,6 +22,10 @@ ** Summary > > It relies on a lightweight plain-text markup language used in files > > with the =.org= extension. > > +Org files can be viewed using any text editor. You can read and > >

Re: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable

2024-01-02 Thread Matt
On Sun, 31 Dec 2023 16:22:00 +0100 Ihor Radchenko wrote --- > > I'd like to amend the Org manual introduction as in the attached patch. > The idea is to highlight that Org markup is designed to be > human-readable first and foremost rather than just computer-readable. > > This is the

Re: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable

2024-01-01 Thread Thomas S. Dye
Aloha Ihor, Ihor Radchenko writes: @@ -22,6 +22,10 @@ ** Summary It relies on a lightweight plain-text markup language used in files with the =.org= extension. +Org files can be viewed using any text editor. You can read and +understand raw Org markup with a naked eye. Although

[PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable

2023-12-31 Thread Ihor Radchenko
to hear any objections before installing the patch. >From f97e3d9b7e346506f0a87b98f4809e612d7e78b6 Mon Sep 17 00:00:00 2001 Message-ID: From: Ihor Radchenko Date: Sun, 31 Dec 2023 16:20:24 +0100 Subject: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable Readability of