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.