From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:700:3204::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id 2KXUIOFZlWWj2gAAkFu2QA (envelope-from ) for ; Wed, 03 Jan 2024 13:58:09 +0100 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id wGs4GeFZlWWmFwEAe85BDQ (envelope-from ) for ; Wed, 03 Jan 2024 13:58:09 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=SRaesx61; 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"; dmarc=pass (policy=none) header.from=posteo.net ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1704286689; 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=BMF+gCV+x7y5lF13sMEZ+KX/e7xWF6+pDz/Upn5eJyc=; b=B+0OP72r5K6CscwJAvZGkCinY02urVJH5DANs9yIJYDF4gBfkxamKZ+XmzB793OVT0LUlQ Sgo/eqpvwFyEqCK/FwEOPi9AK1RmBtZeeMedOwGlMfgnFevSJx/I/EpDTOZUzW0lzm+2oZ gCzswZ7HD15+54TEX5UFL2VssMWddX2o59aK80e6WUyzE6WwYDyHwBNQO7fSnAtaMWHlpi 0CvNx9N2csStJikFxiCut4jS0iAJdyk/ZP//gVwigZ1W2aaQWxasy8lONEtCC0cu+vtMQB Lheh200e3G7G0gouv4u413nm7NgoCKm7Ubsfgai2GWexJGTlsY0yPWWXxPuOGA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=SRaesx61; 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"; dmarc=pass (policy=none) header.from=posteo.net ARC-Seal: i=1; s=key1; d=yhetil.org; t=1704286689; a=rsa-sha256; cv=none; b=doqgodm2imagKE5p8Ebzihb+N/VHg+cQE/8FYwJ/ip6llUQ/RYc4Ky3v5xgtUsWD84uY6j O6tb8bww+pNSpuhE1mVq8iswEP3AQK82J8jExrvUvEzNdu0fIROx3VC6COXMmpwLX1LsBr Bv8gsTSYhsN7kVRPicDrZI9Dd1rzTflW83n3gSfHgq9VKyOhvT2tYuTH9aLtegCSMY+Cpr xhSTpagZJCe9RgrwZUBf+2GvT8m73evVKABrjPyfJ+2SyoIEnc/GZ+5LPNHmzMW/NnRJo1 5A2zcjqQnLKAonZ9q8lzdlUI3+rSGgBjM6pFD8b5gU1KpUSuvXBciD9BzUMsgQ== 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 EDEAD5EA45 for ; Wed, 3 Jan 2024 13:58:08 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rL0oN-0000Vf-8Y; Wed, 03 Jan 2024 07:57:31 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rL0oL-0000VP-J7 for emacs-orgmode@gnu.org; Wed, 03 Jan 2024 07:57:29 -0500 Received: from mout02.posteo.de ([185.67.36.66]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rL0oI-0005up-9A for emacs-orgmode@gnu.org; Wed, 03 Jan 2024 07:57:29 -0500 Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id C087E240103 for ; Wed, 3 Jan 2024 13:57:22 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1704286642; bh=ip9+XlGrvSZctShlpgbEB1k5wxdt8eklW6rnRjPugvY=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:From; b=SRaesx61GO1Y66bIBTJhP5wO95itlV1gcvKxxgJtwtmbPsVOlOm4NdpQTyHFHxPBX KxPKo0ljYzl/+mp3qM4zGQ4iMFFetohC57WOeSJ1BE8gexn8NLlMiG0xbDc4V2Yn9a YLckitpEd68pmO1db66LZqNW5QJOkjNeZRMTtyss8DxTvMBrn32lNiBcinzR0snjXz n/vSa2E7M9yIvlmIM6EOReSOItxbEfBpmCwqI47b5NMIDUKTgJ0UtztwOwTSXHcJ3S 0LgPCY4OgSd3xhZ01pP59/SwlFoaskFLfwIoSfYefNh1mXBpEh17qqRGe/Dl5RBeJR teFrSTQscF82g== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4T4qW54469z9rxL; Wed, 3 Jan 2024 13:57:21 +0100 (CET) From: Ihor Radchenko To: Jean Louis Cc: "Thomas S. Dye" , Bastien , emacs-orgmode@gnu.org Subject: Re: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable In-Reply-To: References: <87il4e75u8.fsf@localhost> <87v88c5m9j.fsf@tsdye.online> Date: Wed, 03 Jan 2024 13:00:29 +0000 Message-ID: <87r0iya7wy.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=185.67.36.66; envelope-from=yantar92@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_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=unavailable 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-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Spam-Score: -6.51 X-Spam-Score: -6.51 X-Migadu-Queue-Id: EDEAD5EA45 X-Migadu-Scanner: mx10.migadu.com X-TUID: mfRvs1sRyRw3 Jean Louis writes: > In my opinion, it's not that Org was intentionally designed to be > "lightweight markup readable for humans"; rather, it was maintained in > a manner that focused on preserving its readability and prevented it > from evolving into something less comprehensible. The point of my patch is not to show history of Org markup. Rather to guide the future direction - if we ever add new or change the existing Org syntax, readability is one of the design guidelines we should follow (IMHO). Stating it explicitly in the manual will make this guidelines explicit. -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at