From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id KHKgM4urrGF2GAAAgWs5BA (envelope-from ) for ; Sun, 05 Dec 2021 13:07:39 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id 4HtlL4urrGEJAgAA1q6Kng (envelope-from ) for ; Sun, 05 Dec 2021 12:07:39 +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 3A6C6A615 for ; Sun, 5 Dec 2021 13:07:39 +0100 (CET) Received: from localhost ([::1]:44888 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mtqIr-0002wn-Ay for larch@yhetil.org; Sun, 05 Dec 2021 07:07:37 -0500 Received: from eggs.gnu.org ([209.51.188.92]:40124) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtqI7-0002wd-As for emacs-orgmode@gnu.org; Sun, 05 Dec 2021 07:06:51 -0500 Received: from [2a00:1450:4864:20::12c] (port=37660 helo=mail-lf1-x12c.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mtqI2-0007wB-O5 for emacs-orgmode@gnu.org; Sun, 05 Dec 2021 07:06:51 -0500 Received: by mail-lf1-x12c.google.com with SMTP id c32so18358133lfv.4 for ; Sun, 05 Dec 2021 04:06:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:in-reply-to:references:date:message-id :mime-version:content-transfer-encoding; bh=7FkH9ziEAZzBVsJK6YLsLc5UAmmHUUezcYyxsbPIhOI=; b=q3rO20M+alU9sYvKJgGW6yw8MxkuErU1Bd4F3Gik/XxH2rON7X1jGavZrRtAXtjQis qIn7BkRTcQNx9ipRAOHgXD/W1Cr7AP1crK1uFHdU60cIOOUZH1flkZ0P/CZ6K/aCPHeA ec3G01PfOdPAZJq9RVWiS9cKMFxRZTbswlfg0TIvAtbIW9mQ8k2Vyho2x5Qt96LJCaRr pnEv8ZEKdNwIt3Ew03Ifp+mny01JOUR4ClOPRcULq96ZkEiwd40Uycl7ET8FJBsWIb9M WQcG/YrY2zoIxrcLb7DnJA2enzZ2xYRQDPAbSLWLpLbkzpKUzAGp2G/0XDHOuuQrmIis aWxQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references:date :message-id:mime-version:content-transfer-encoding; bh=7FkH9ziEAZzBVsJK6YLsLc5UAmmHUUezcYyxsbPIhOI=; b=iMgOkVTAvp+8WD7G0nKdcx4FKGzcO7c1IBnfQzXR32wbIzP7bUwC4gEneDls5gZ2k0 8zqbn12QInONdTcddywNuLaAC5r87eKW/jgpgGHzMCX+3nF4IXQ1Pf7bM/6iI+dNp38+ HUkSB54fRiIwG64Nvb0UCbAx7Sq7HrB2gLT/vqTnPzUuhregGLWvty0jUK1h90Kjwq5h AZK7KzItIuMj3Ex/fYM2zT8yDv42YRCKIEv8k23v6FnTcIYMKR8X3xhBPwjrkoGUG8A+ hVLaw3uBc9Xv6X7jT2P6eurJ64uPFwHWPkpjGdhXeA6Fh0paKGoZN9K+KPFHrlAaBgWv vYAQ== X-Gm-Message-State: AOAM532ClDz8Za2S1qG0cPa58WF7AjR+vKFoC60EMZyqMhukfMDqDwzH lqxsl6ha2g3YOlNoZxOSsxo= X-Google-Smtp-Source: ABdhPJyVnAbgM8i1964p1BtdDiFdFMFW2RCDxslGF1scxTd04IUl9ibFUZHkNlrXQJVIArZalZtdSQ== X-Received: by 2002:a05:6512:3da2:: with SMTP id k34mr28569157lfv.605.1638706004730; Sun, 05 Dec 2021 04:06:44 -0800 (PST) Received: from localhost ([158.255.2.9]) by smtp.gmail.com with ESMTPSA id y7sm7077lfj.90.2021.12.05.04.06.43 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 05 Dec 2021 04:06:44 -0800 (PST) From: Ihor Radchenko To: Juan Manuel =?utf-8?Q?Mac=C3=ADas?= Subject: Re: Concrete suggestions to improve Org mode third-party integration :: an afterthought following Karl Voit's Orgdown proposal In-Reply-To: <87y24zs40r.fsf@posteo.net> References: <87tufnbj1w.fsf@localhost> <87sfv75s4r.fsf@posteo.net> <87o85vbb9a.fsf@localhost> <87y24zs40r.fsf@posteo.net> Date: Sun, 05 Dec 2021 20:08:09 +0800 Message-ID: <87lf0zb6fq.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a00:1450:4864:20::12c (failed) Received-SPF: pass client-ip=2a00:1450:4864:20::12c; envelope-from=yantar92@gmail.com; helo=mail-lf1-x12c.google.com X-Spam_score_int: -10 X-Spam_score: -1.1 X-Spam_bar: - X-Spam_report: (-1.1 / 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, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, PDS_HP_HELO_NORDNS=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RDNS_NONE=0.793, 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: , 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=1638706059; 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: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=7FkH9ziEAZzBVsJK6YLsLc5UAmmHUUezcYyxsbPIhOI=; b=FByM66I6cvFuclgOw4Pio9tJ7byqnJkQv7u0mW2/cBi9B95e1LqjJSSXcKz/fPEjNk7TNP g9oJ5Vgo+37QZ3OQ9fKMCuoKWAnFX4hkdRs2IsWdZ2yZGI7+5RVk1yuZ7TxTT4C8Na9nYt ExevVTdBeuPVNJLq6FVQ/2+d2qbA0GiGku0ltge7HmuFrEkFZSP/I/HeEShwBahnGcrq0w QTVNRmfC1LFsOTs3Mqt3O+qSF8Y6ecOXAL0rM5rk8Jpm0zia+46jBBa/h7wbm7eASZCr+s I1Euq2Ps75mO6l3mXIPW65Si+B+DikMSaHGJaHFmGw8TsiObaaVfaTE338VhSw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1638706059; a=rsa-sha256; cv=none; b=tq/jeJetiA7ZAtjNhQ7eidecvYms4VQ+ExZ7kBZ/h6rRCMagkbhhR9xTd9I5AvtQWJWdsy kGdi8K6dc+HBg9TYZar4FB1IDjq7KbwA9iw2Xyl7EwbUi04XnMOem4/S/do4YZ4p7+KXLD Op1rkXgVZYB8npO377BasZ4+LPGlWphZWACEnnqYsoIkgzamDDYIHcjUnS/ZmJW4QDEeX0 CXyMOHhDh/1CbWhM0RumeHsHhwDKzjOyvJ1bhLWtaXnoLtTkk5/tjdHAsxMr6Tkaz0XQ4W f+tDxhsnotyoTJLXVcY0b5Ledr33hrSUpeD+2nX3wdS/O+5dnPU6xf7LtDJMvg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=q3rO20M+; dmarc=pass (policy=none) header.from=gmail.com; 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: -3.64 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=q3rO20M+; dmarc=pass (policy=none) header.from=gmail.com; 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: 3A6C6A615 X-Spam-Score: -3.64 X-Migadu-Scanner: scn0.migadu.com X-TUID: sPwXZeMKLYbW Juan Manuel Mac=C3=ADas writes: > Yes, sorry for not explaining myself well: I was also referring to > search results, not the title in the web site... > > But the question is: what need is there to remove the reference to Emacs > in the search result? I think the emphasis is necessary. As we say in > spanish, it's like putting the bandage on before the wound. If there are > people who think that Org Mode can 'live' in some way outside of Emacs > (a respectable opinion, but that I do not share, at least 100%), I think > the burden of the work falls on them and not on us, the users of > Emacs-Org-Mode. Anyway it is my simple and subjetive opinion, and it is > not my intention to initiate a controversy with it. 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"?? =20=20=20 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]). Best, Ihor