From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id aNoPHHSNpmH4bAAAgWs5BA (envelope-from ) for ; Tue, 30 Nov 2021 21:45:40 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id KTV2F3SNpmHKPgAAbx9fmQ (envelope-from ) for ; Tue, 30 Nov 2021 20:45:40 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id A578F10684 for ; Tue, 30 Nov 2021 21:45:39 +0100 (CET) Received: from localhost ([::1]:48712 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1msA0P-0007Gj-I6 for larch@yhetil.org; Tue, 30 Nov 2021 15:45:37 -0500 Received: from eggs.gnu.org ([209.51.188.92]:35700) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ms9zb-0007Fw-RN for emacs-orgmode@gnu.org; Tue, 30 Nov 2021 15:44:47 -0500 Received: from ciao.gmane.io ([116.202.254.214]:36942) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ms9zZ-0007WT-Ek for emacs-orgmode@gnu.org; Tue, 30 Nov 2021 15:44:47 -0500 Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1ms9zX-0005Bh-KD for emacs-orgmode@gnu.org; Tue, 30 Nov 2021 21:44:43 +0100 X-Injected-Via-Gmane: http://gmane.org/ To: emacs-orgmode@gnu.org From: Karl Voit Subject: Orgdown: negative feedback & attempt of a root-cause analysis (was: "Orgdown", the new name for the syntax of Org-mode) Date: Tue, 30 Nov 2021 21:44:30 +0100 Organization: www.karl-voit.at Message-ID: <2021-11-30T21-02-53@devnull.Karl-Voit.at> References: <2021-11-28T20-44-37@devnull.Karl-Voit.at> <875ysb7v1r.fsf@gmail.com> <2021-11-29T14-12-55@devnull.Karl-Voit.at> <87tufuu8ah.fsf@atlantis> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit User-Agent: slrn/1.0.3 (Linux) X-GPG-Key: http://www.Karl-Voit.at/Karl_Voit_GnuPG_public_key.gpg X-Registered-Linux-User: 224337 X-Confession: Pastafarian http://www.venganza.org/ Received-SPF: pass client-ip=116.202.254.214; envelope-from=geo-emacs-orgmode@m.gmane-mx.org; helo=ciao.gmane.io X-Spam_score_int: -16 X-Spam_score: -1.7 X-Spam_bar: - X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.249, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Karl Voit Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1638305139; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post; bh=YY/jWEduoDFNl5u98MUbH7CTI8XY3pQMrjzwpNWy0ws=; b=bGhJQfiRCgk/Wgi0P5FxSIVqIofC2/z6iDV7XdfhQbdt2qsR1Mctn7HZBtkYnuln6Nwgfz 1Tbd2OzqNySuWWnHfDP34yd+InXem8F9rM4KXOE/UtQkGo6+aJ0zYDmpOwnRNxBN0OYvOe 4lEqrSHeA7MN9XTrDbHWjuya79fcFSww92MJPS7oWaAKpml3UmNGW/8RavSDXBT6mkIgPd bFX+pEnuWCLxAUIKU5Y72wRAs18fdNRuztWdkQzSwjJjKje0AqMjj6Kauubu9miIqVeQI1 obV9A5Cawqx9J8tXALNHNMyprVo5MwdDsa5HQvf1Y/nuwL6Xe1oKgu2PVYBTTw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1638305139; a=rsa-sha256; cv=none; b=QYN+wnuwiqWY8wqXmQK5qyZnJ5P6oSvanpqcaEMez6B62DGL85Qh86WxZrcMcli0FkHY1u 6QBhFPXnHNCywEljuSneTZdPHVtywvBtF0GKNjotpbwyPgdVEsSPh/v5FFvzdi8RUYGGDP 7FWqT1VclFtaBw8QhjJBeTUbvBh0mA4Y4nrJaHVDQ3Ve/SbpRIbfLfXssmGep1FH9EvIZq sUWoTevNzz8O1deUvlx65mIZf3xV7h+bsoUNKNGkIcjK8j8eT4l5ZxlUHBIbFiLTU77dri 2ezGYA+y3laO5uvrSBXy0Zl1emUBowLJymJJM+zD7RgJbOMcJg8TsG485/Z/ig== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -2.41 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: A578F10684 X-Spam-Score: -2.41 X-Migadu-Scanner: scn0.migadu.com X-TUID: np02a3fEgNr+ Hi, * M ‘quintus’ Gülker wrote: > > Am Montag, dem 29. November 2021 schrieb Karl Voit: >> It seems to be the case that the name "Orgdown" is the reason why >> the Org-mode community does not support the idea of an >> implementation-agnostic definition of the syntax. Which is ... kinda >> funny if you think about it. >> >> Well if the project is not working out, at least I made my point and >> we continue to have all those misunderstandings and lack of Orgdown >> support in 3rd party tools (because Org-mode is way too big). > > I think the project has value; better tooling outside of Emacs is > something org can only profit from in my opinion. One point that has not > been raised yet are scenarios of collaborative work; I would enjoy it > quite a bit if I could work on documents together with people who do not > like Emacs as an editor for whatever reason. Currently, org as a file > format is pretty much excluded if collaboration is intended with someone > who does not use Emacs. The natural choice in these cases is Markdown. I agree. One of the next things I do have on my list is to try out crdt as I've learned at EmacsConf21 that it is mature enough to be used in practice. If that holds true, we can start dreaming of having a Etherpad-like session from our GNU/Emacs while peers are connected to the same session via some web-based tool/service. > I agree that the name is kind of odd as it seems as if it is necessary > to invoke some association to Markdown. Other markup languages also do > not need that -- Textile, Asciidoc, etc. Perhaps it is best to simply > ignore the naming issue and focus on the actual work instead. It is far > more important to get the compatibility levels defined. After that you > can still reconsider the naming. The dominant feedback of https://www.reddit.com/r/emacs/comments/r4cq3o/orgdown_the_new_name_for_the_syntax_of_orgmode/ was negative comments on the name and nothing else. Even here, although due to a much more civilized style, the name choice was the dominant topic and not the idea. I have to take this as a strong signal here and I'm very close in giving up on Orgdown as a project. I did underestimate the power of the name choice as I clearly was impatient because I was looking forward to interesting discussions on the idea itself like in this sub-thread. There were two possible generic approaches for me: start from zero with an open process, involving peers in all choices such as naming, Orgdown1 syntax elements, ... While this approach offers maximum community involvement, my fear was to get into too many long discussions about details before I could express my vision to anybody in a concise way. Second approach: define everything myself up to Orgdown7 (as an example) and publish with a big bang. The downsides here are obvious. I chose an in-between approach: defining only a minimal set (name, common structure/idea/documentation, Orgdown1, providing a collaborative home on GitLab) and hope for a project community that will take over (or at least support) from there, discussing syntax elements for Orgdown2 and taking the project to its next logical steps. In hindsight, this decision was wrong. Quite frankly, I don't have the energy to throw away everything and start from zero with a different name. People do not seem to realize what it took to get there - which is partly understandingly because I had to learn by doing what it takes to get the idea into a coherent and consistent form. Simply switching to a different name is not just search&replace. It would reset the project almost to its very start again, losing the go-live effect of previous weekend (whose effect might be questionable considering the name discussion), its project URL that is now out there, the motivation video which aims to explain the motivation to users of Emacs, the EmacsConf21 talk publicity, and it would require much effort to reach the status where Orgdown is now. >> Oh, there is a very large danger here of getting something that is >> not compatible with Org-mode any more. I don't think that this would >> be a good thing. At least the different flavors killed the fun of >> Markdown for me. > > The astonishing thing is that most people manage to get along despite of > the incompatibilities of the different Markdown flavours. Otherwise > Markdown would not be such a success. Why is this? What can be learned > from this for creating org tools outside of Emacs? Actually surveying > this might be of interest. I agree and I have thought about it myself already. My guess is that most people do not suffer much from different Markdown flavors because they rarely mix them in their workflows. I guess most people are using Markdown only in their text editor OR only in GitHub/GitLab org files OR only within any other Markdown-tool. I might be in an unusual situation where I do have to work with GitHub/GitLab flavored Markdown README files AND with DIY company solutions that work with pp (the preprocessor) to generate documents from a specific Markdown flavor AND with reddit Markdown flavour AND so forth. If this holds true, than this might be a weak argument for an alternative markup instead of Markdown after all. Bastien told me that he would be interested to see hard numbers on my assumption that Org-mode syntax is easier to learn and type in comparison to other LWM. And he is right: some research work in order to get numbers would be awesome to shed some light on the forest of assumptions. Maybe somebody in a position to realize such a case study gets motivated now? ;-) Does "assuming too much on other people's world because on my own small world" have a scientific name? I might be in danger of having this disease? *g* > Maybe most documents are very simple files. README files for FLOSS > projects, forum posts, blog posts. For such content the features where > the Markdown implementations differ are usually not required. This sounds also a plausible explanation and is also boosted by another posting as an answer to yours. > It suffices to use unstyled text, headings, code blocks, quotes, > emphasis. That is it basically. org shines on documents where > more is required -- documentation, books, since recently > scientific articles. Markdown’s common subset is not expressive > enough for these documents, whereas for simple documents there is > not much benefit in trading in Markdown for org. Thus, maybe it is > more fruitful to try to market org(down) as a markup for complex > documents, with the added benefit that it does incidentally also > cover simple documents nicely on par with Markdown. Hm. I have to think about this. If this path is followed, then it might be hard to find target groups willing to switch away from WYSIWYG tools which is the only alternative I can think of here. I don't think that users of LaTeX/ConTeXt are part of the target group. They would actually lose a bit of having control, I think. And Overleaf might be too hard to beat I guess although I personally don't like to use cloud-based services but meanwhile that's the opinion of a tiny minority. However, nice input and thankfully not just about the "horrible name" for a change. Thank you for that. ;-) Karl