Dear all,

We currently have two versions of Org syntax in WORG:
1. https://orgmode.org/worg/dev/org-syntax.html (old, not always accurate)
2. https://orgmode.org/worg/dev/org-syntax-edited.html (new, being
   discussed in https://orgmode.org/list/871r1g936z....@gmail.com)

The old syntax page is apparently ranked higher by search engines,
creating confusion among users (see the above discussion and the below
message sent off-list).

Maybe we can move org-syntax-edited in place of org-syntax at this
point? I personally think that Tecosaur's version is strictly superior
to the old draft, even though is can still be further improved.

WDYT?

Best,
Ihor

c.bu...@posteo.jp writes:

> Am 04.04.2022 09:44 schrieb Ihor Radchenko:
>> WORG is also official, though serves more like a wiki and not as
>> official as the manual. In your particular case, we are currently in 
>> the
>> process of updating the WORG syntax page.
>> https://orgmode.org/worg/dev/org-syntax.html is an old page explicitly
>> stating that it is a draft ("Org Syntax (draft)"). I recommend using
>> https://orgmode.org/worg/dev/org-syntax-edited.html#Items if you want 
>> to
>> check more up-to-date formal syntax description.
>
> For newbies (and for me) it is unclear why there are two "version" of 
> syntax documents exist. The is confusing.
>
> Minimally the worg-version should point to the "official" org-version 
> and back. When googling org things the worg pages are on top most of the 
> time.




Reply via email to