From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id GBroFy4MrWFtDgEAgWs5BA (envelope-from ) for ; Sun, 05 Dec 2021 19:59:58 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id YMyNEy4MrWFlaQAAB5/wlQ (envelope-from ) for ; Sun, 05 Dec 2021 18:59:58 +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 C90982E650 for ; Sun, 5 Dec 2021 19:59:57 +0100 (CET) Received: from localhost ([::1]:32878 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mtwjs-0003bJ-LM for larch@yhetil.org; Sun, 05 Dec 2021 13:59:56 -0500 Received: from eggs.gnu.org ([209.51.188.92]:48442) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtwjT-0003b3-3N for emacs-orgmode@gnu.org; Sun, 05 Dec 2021 13:59:31 -0500 Received: from mout02.posteo.de ([185.67.36.66]:47875) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtwjQ-0007sq-6W for emacs-orgmode@gnu.org; Sun, 05 Dec 2021 13:59:30 -0500 Received: from submission (posteo.de [89.146.220.130]) by mout02.posteo.de (Postfix) with ESMTPS id EEA64240104 for ; Sun, 5 Dec 2021 19:59:24 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1638730765; bh=gkneM3jk5dxzOX9BJnNVylfrVOYJuwkvyhU75MF3bto=; h=From:To:Cc:Subject:Date:From; b=FPqtjkPZzy84UXDBNAbYnFCJeLrGb2s2C9l1x8aAp3t9s/Ii0U1XaiCDLfAt/DBiz R5Sn91rRbxkdim8qM/AO+W5qJm5xxqJb/GBFj11Sd12W+YW9VTIlqomERiqdKUAFY4 Jm49apJEBQwG/dAbynOJlM9TbZvtV2v089n4Gh6GjFxWczezw9eQaqxXRIjLessDvh P6/l4+81P1iUHMQh0VygMu+S10TD5+Y6qFUSLXlb8T5zYZSUy4CDscNnqZhIhq2krt fHMTAqeW3TF+v3XMoH864eBTniLkZoaS3h5wlL/AZTlK1nWFyhZOdVkIx+ZDu9GrQs bwha428r1qdHg== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4J6bT658Trz6tns; Sun, 5 Dec 2021 19:59:22 +0100 (CET) From: =?utf-8?Q?Juan_Manuel_Mac=C3=ADas?= To: Ihor Radchenko Subject: Re: Concrete suggestions to improve Org mode third-party integration :: an afterthought following Karl Voit's Orgdown proposal References: <87tufnbj1w.fsf@localhost> <87sfv75s4r.fsf@posteo.net> <87o85vbb9a.fsf@localhost> <87y24zs40r.fsf@posteo.net> <87lf0zb6fq.fsf@localhost> Date: Sun, 05 Dec 2021 18:59:20 +0000 In-Reply-To: <87lf0zb6fq.fsf@localhost> (Ihor Radchenko's message of "Sun, 05 Dec 2021 20:08:09 +0800") Message-ID: <87pmqasws7.fsf@posteo.net> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=185.67.36.66; envelope-from=maciaschain@posteo.net; helo=mout02.posteo.de X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham 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: , Cc: orgmode 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=1638730797; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=enR7FHAKcj3+3752voIoMT6W1nwlHi2FlLhf3bVTp/4=; b=uBn51FYLP96zfSZ+y4GXFE41PhW3LUfWFusfwBh2+4mdOy+rJcyJcTLonWeH9xs3hHx6tP B1raHosnFejYBD7KtMS7+KtPE53EDeGK5xSmx5g6tJQ+tBt3P+59Lgs8Yk8fgiq8zCg3k1 DT9HfUVi1rwLAkZ1qvASyvjaQMYM9s8xEebAAromh0cduhnWn4jo78TnKDm0f/DpzoLrRG VJkUTkdb9aJ713B1iKEhWMcwpevznsHjhyoNW1ClPiHB/IZBLeQdFlqj0jMcnh/3FR/GKT rwN8oRBG3z1T4s5WAr10D+QkUH94iAwCzw8AtQQYWNCvQQoel1T0hrxOWdqrJA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1638730797; a=rsa-sha256; cv=none; b=S+oBG9RRdqopqAW0OJzeWilEosa4qCc2af5h2DgP24pn+U7GHgzdX5FiUza6YNNKpzCMao 8r+lwbKsLXEIdbUyTQXWj8GfGtNSUCZzDgL4Hg+4ZJVWcZ1EWabOObAaCeWI3lJ1GuEYdF 9rzpd07+uXUF+6x4z207KAtCK7jtMPWoNJglJi7JkDLGvOjBdqO0orf55cdAGvl57fQeQa 97WoY+g1we6Hde0YY1Nm2Ep/47oH8IMrLa9vnGxDw2VmYae8GiW2sOieVCks9TrjVIirqK 3WtX8VxqRsJJwDaXcTaKNIM4yVleC40fngoPKNUOGNslbFvEJrGQr6yV19EJow== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=FPqtjkPZ; dmarc=pass (policy=none) header.from=posteo.net; 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: -4.34 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=FPqtjkPZ; dmarc=pass (policy=none) header.from=posteo.net; 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: C90982E650 X-Spam-Score: -4.34 X-Migadu-Scanner: scn0.migadu.com X-TUID: 6i32zNjajI0p Ihor Radchenko writes: > Ok. Let me explain my thought process. > > First of all, there is no burden on users of Org mode in making edits to > orgmode.org. It is a burden on Org contributors. > > One of the aims of my proposal is reducing this burden by involving > non-emacs users to provide contributions to Org (e.g. by making more > tests for Org-element parser). To do it, we need to make the > contribution process for non-emacs developers easier. Ideally, without > too much effort on our side. > > The idea of involving non-emacs users does have a potential because we > do know that third-party tools are already using Org. The problem is the > disconnect between those tools and Org mode proper. > > The sources of the disconnect are (1) lack of technical "blueprints" for > Org that do not require knowing Elisp; (2) lack of discovereability of > Org mode as something that can live outside narrow field of Emacs. In > this branch of our discussion, I am going to talk about the second > point. > > People simply do not expect to see a markup language when they encounter > a link with "Org mode for Emacs" title. Someone looking for Org mode > markup to be used in, say, websites will think that "Org mode for Emacs" > is limited to Emacs. Someone just interested in plain text markup will > find no relevance at all. > > Title is important. If we care at all about orgmode.org website > appearing in search results, we want the title and the summary to have 2 > main properties: (1) Provide search keywords to make it searchable by > potentially interested people; (2) Provide a title that immediately > signal that our website contains the information people are looking for. > > Now, we need to understand what kind of people may be looking to > orgmode.org website. > > 1. Existing emacs users > > If a Emacs user is faced with "Org mode for Emacs", the word "Emacs" > is indeed recognisable. On the other hand, the word "Org mode" does > not provide much further info, except that it is a major (or maybe > minor?) mode for "Org"?? > > Now, consider "Org mode: your life in plain text". > For emacs users, "Org mode" is not just a strange phrase, but a very > clear indication that we are talking about Emacs. > The "your life in plain text" provides extra information about what > "Org mode" refers to. Clearly, text documents and "your life in plain > text" should resonate with every Emacs user's soul. > > We can change the second variant of the title to contain "Emacs", but > will it add much value? I am not convinced. On the other hand, making > title too long or too complex _is_ bad. Long titles tend to be > skipped (there was even formal research on this!) > > 2. Non-emacs users interested in plain text markup > > These users know nothing about Emacs and "Org mode" has no meaning > for them as is. So, we do need something more descriptive. > Adding "Emacs" may be fine, but it will serve no purpose for people > not familiar with emacs. Just another unknown term making the title > longer. > > 3. Non-emacs users interested in GTD/project management, etc > "Org mode: your life in plain text" is somewhat relevant when people > are looking to manage "life" (typically true for GTD enthusiasts). > > Though we can probably do better for this category. > Maybe "Org mode: manage your life and notes in plain text"? > Though it makes the title less relevant to group #2. > > 4. Researchers looking for ipython-like environment > > Not covered, except by reading my proposed site summary. I am not > sure how we can improve title for this audience. > > 5. ??? (Suggestions are welcome) > > Of course, better suggestions for the title are welcome. I just wanted > to make it clear the reasoning I do not like the current title and how > the proposed alternative is better (though not ideal). > > Finally, I want to emphasise that our aim for search engines is not > advertising Emacs (we already do it by trapping users inside Org and > making them switch to Emacs by force :evil_laughter:). The aim is > encouraging people to use and contribute to Org mode in useful ways > (even unrelated to writing Elisp or, really, any code at all). > > Search result is just an entrance for users to be curious about the new > beast of "Org mode". The website front page is the means to make users > try. And the Org mode itself is the way to make users fall in love with > Org in one way or another (even unrelated to Emacs [at least > initially]). Ihor, thank you very much for explaining your motivation in detail. I think I understand it and (on the important points) I share it. In my case, as an Org Mode user I often feel a mixture of happiness and frustration. Happiness on using Org. Frustration every time I want to recommend Org to many of my friends and colleagues, who don't even use Emacs. GNU Emacs is a great, labyrinthine, fascinating building. Almost like a city. And Org is a room on one of the upper floors. In the Org-room (including Org-Roam! :-) there is a lot of fun, great people, great music. But whoever wants to get there must go through a series of levels, intricate corridors that are like a kind of learning path. Emacs is great, but you can't learn to use it in two days. It takes time to adapt it to your needs, get to know it, even love it. Sorry to be so metaphorical and poetic, but it is the only way I can find to explain what is, in many ways, a personal learning process (even the init Emacs file could be understood as a kind of autobiography...). I wish the entry into Org was smoother and more direct, but being an Emacs mode, it is necessary to go through Emacs. And this gets more crude for non-technical, Humanities users, who I think could be very happy using Org and not Word or other modern auto-torture methods :-) I came to Org been an Emacs user already, so I was reasonably familiar with Emacs and Elisp, although what I used most was AUCTeX (and Markdown for my docs). I heard about Org but it never caught my attention, until one day I read the Org compact guide and I was fascinated that such a thing existed (and it was just the compact guide!). TL; DR: I understand and share the maneuver of baiting new and potential users. But I see it difficult. Users who have never used Emacs will have to go through the Emacs learning process first, especially non-technical users or those who come from the country of word processors, that is, Mordor. On the other hand, Org as a lightweight markup language is only a tiny part of Org. I don't think Org is better or worse as a markup language than Markdown, asciidoc or other similar formats. I think the important thing about Org here is the integration of a series of resources: a whole that is more important than the sum of the parts (https://en.wikipedia.org/wiki/Emergentism). Best regards, Juan Manuel