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 0JOlLbjBrGF4XQAAgWs5BA (envelope-from ) for ; Sun, 05 Dec 2021 14:42:16 +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 CPRmKbjBrGFHFgAAB5/wlQ (envelope-from ) for ; Sun, 05 Dec 2021 13:42:16 +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 384C229370 for ; Sun, 5 Dec 2021 14:42:16 +0100 (CET) Received: from localhost ([::1]:37366 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mtrmP-0007Ep-Sg for larch@yhetil.org; Sun, 05 Dec 2021 08:42:13 -0500 Received: from eggs.gnu.org ([209.51.188.92]:52176) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtrlq-0007Da-Lf for emacs-orgmode@gnu.org; Sun, 05 Dec 2021 08:41:38 -0500 Received: from [2607:f8b0:4864:20::430] (port=45819 helo=mail-pf1-x430.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mtrln-0007cO-LP for emacs-orgmode@gnu.org; Sun, 05 Dec 2021 08:41:38 -0500 Received: by mail-pf1-x430.google.com with SMTP id x131so7607251pfc.12 for ; Sun, 05 Dec 2021 05:41:35 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=references:user-agent:from:to:subject:date:in-reply-to:message-id :mime-version:content-transfer-encoding; bh=6Dy28zVHI5WymSwEO3314YkKh+24vR1jV2bGDaI2tNM=; b=FrdAXbZ5LTQVZL5lcOkYzv00xFoAhmn1xRce/kE2vf5sP5URMbDwb3JlMWkMKvnQky vHZkXL2kuqwq99I7jUQqPaCn4WkjtJMpvrQXstFs1hJbqcCbBMbHjmbnJc8NSOw1KfLU 6BpnWs2th1hjM0O+w7qrKQXB9+RYBJh+0w066dXRHrTK8qD9CEzmrXDMOe4ZN3sQTyxW eMs1BlYlAweH6FwgmhQsca62zXi/3TWJoQKPkRvpA2IOPFrBdtVnC5r7/G5u6emFvJFC JhMRzfQyZAgU19bhDN4MebXycTPerwxNDCMbsnxP/YO3F/8hckUaxFYLSk9bJeDE0LeT r6qQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:references:user-agent:from:to:subject:date :in-reply-to:message-id:mime-version:content-transfer-encoding; bh=6Dy28zVHI5WymSwEO3314YkKh+24vR1jV2bGDaI2tNM=; b=GMcmCDLnawdf1tNm77F5MZiOmGpFbLWcmkysaSiQ1QHMDAh9NMds63E/VRFeMDqPfa jZ62F+y885zEqbsDpoMSSt4X9FSsfsQrL/UQ9f5tMrYJsNiZnW0QSpuoFPaq+PMrBkPW 5pWS1gZXBNNYfcMSOD9/A0p42AcOPNhB4SLBi7DEaqwPxPcmF7dmwS7FPjmiSmvvreHs JeNyoTsFsEZUM82sop5GGxZlNR2j0ZeJkin115e9TGaJ5NDPfZG40zH9CSSkXEgl1meG WOXvAazpIjvldCYFlZQYGc2kVg+tXx237ui2pt7MZaJETnWYKf/criWqm+Iw5nxluedW i5gg== X-Gm-Message-State: AOAM530+W2Ogg8gh5pKdElQnRs+EkqaDuEWopiqmTTLrsfhw8Pm3bjeF vRyaJ4m4+MoQCfRPsghM7hO/EJmJFhY= X-Google-Smtp-Source: ABdhPJxjVoHOD0nvBJlaE+o2hB8UQRq3TUyb4wEzB/ieb+7ytn685PQjaELAR6sq/OGhFg4d/VUyiA== X-Received: by 2002:a63:ae45:: with SMTP id e5mr3119763pgp.284.1638711693861; Sun, 05 Dec 2021 05:41:33 -0800 (PST) Received: from dingbat (2001-44b8-31f2-bb00-b2a4-98c2-11aa-1b70.static.ipv6.internode.on.net. [2001:44b8:31f2:bb00:b2a4:98c2:11aa:1b70]) by smtp.gmail.com with ESMTPSA id j17sm9002725pfe.174.2021.12.05.05.41.32 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 05 Dec 2021 05:41:33 -0800 (PST) References: <87tufnbj1w.fsf@localhost> <87sfv75s4r.fsf@posteo.net> <87o85vbb9a.fsf@localhost> <87y24zs40r.fsf@posteo.net> <87lf0zb6fq.fsf@localhost> User-agent: mu4e 1.7.5; emacs 28.0.90 From: Tim Cross To: emacs-orgmode@gnu.org Subject: Re: Concrete suggestions to improve Org mode third-party integration :: an afterthought following Karl Voit's Orgdown proposal Date: Mon, 06 Dec 2021 00:32:07 +1100 In-reply-to: <87lf0zb6fq.fsf@localhost> Message-ID: <87ilw3419x.fsf@gmail.com> 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 2607:f8b0:4864:20::430 (failed) Received-SPF: pass client-ip=2607:f8b0:4864:20::430; envelope-from=theophilusx@gmail.com; helo=mail-pf1-x430.google.com X-Spam_score_int: -12 X-Spam_score: -1.3 X-Spam_bar: - X-Spam_report: (-1.3 / 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_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: , 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=1638711736; h=from:from:sender:sender: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: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=6Dy28zVHI5WymSwEO3314YkKh+24vR1jV2bGDaI2tNM=; b=Og8BY01cQOdkplJEsf2CH/HWix5gqsa3PWVkKA/+ZJ2gLMggFYeI6smtqNfUS9HKCFK+fN el6gBET2kZBWRhY9+8se9Y+UNdWQZM0qvgF2iCAzZZHAE25LNc37y2GaUR54CsuOkXuzDn oVttTk8yT+ifxdy64cgco1ae4r40uP/a96cN8qg5CLaOjPwHNW0vLMyZN4MSDZ5AwMXtd8 BYinv6Er9naE9cXiUkXxvfVKXTSHDeyWpgR1lMA+WFm2IiN901BXmFklHd6PKfzQf0I4GQ zicZ4VS6IgVOkPqWxhUWjJuRFbu4Cu0k6KNYkQIBtV7kA7A6EoCe23AMLD/H/g== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1638711736; a=rsa-sha256; cv=none; b=GIfR6T8fHyYu32hs5oYOra4bBRfp92cg/pzoEL3S3PBf/0+nkaayd7bxmXyvnsImRT6tiM YjkLtS4vcsAkBbWa+f3mhs7r/sr0oDXUHfODe+dL5RuV+B3oCFD9+6rgRBSZLfxVSX3qri SMennZiqoI1rREi5v1RC/W3HWh+peZTKO4Uc7Yec+TtnOQ85k6R1KAB5ls7WasgGCGkV5z 5EegY0wgQwtquIjA7inFb0+mGFwg9SAnIglsUWdG4lK00TtE9pf4ZZo+IG4SvN9CUCBPFD JmCK29EqD14xXsutqTHU3TFSyQ37yVRYpyHJNPkOHgirpM8GC6otigpmq2qDZw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=FrdAXbZ5; 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: -4.14 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=FrdAXbZ5; 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: 384C229370 X-Spam-Score: -4.14 X-Migadu-Scanner: scn0.migadu.com X-TUID: lvD3N64M0pJj Ihor Radchenko writes: > 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=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]). > I think your working off a false premise. Your view is that org mode should be available in other editors/software so that others can realise the power and benefits it provides. I can understand that position. However, the FSF position would be exactly the opposite. They would argue that orgmode is a powerful and flexible tool that is part of Emacs and if you want that power and flexibility, you need to use Emacs. Org mode has probably done more to bring new users to Emacs than any other Emacs mode in the last 30 years. As a consequence, you will find not only little support towards making it available in other editors, you are likely to run into active resistance. As you say, org-mode can be thought of as a brand name and that is a brand name owned by the FSF as an official GNU project and a goal of the FSF is to convert people to use GNU free software. Anything which has the potential to take the power of org mode and make it available in non-free software (not simply open source) is not going to be supported or welcomed.