From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: "T.V Raman" Newsgroups: gmane.emacs.devel Subject: Re: Org mode and Emacs Date: Mon, 26 Sep 2022 06:58:31 -0700 Message-ID: References: <87y1u8b1gj.fsf@gmail.com> <8735cgot9x.fsf@gnu.org> <87v8pag7nw.fsf@localhost> <87illaae79.fsf@yahoo.com> <8735cebqsm.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=gb18030 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="14809"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: Po Lu , Ihor Radchenko , Payas Relekar , emacs-devel@gnu.org To: Bastien Guerry Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Sep 26 16:14:36 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1ocosT-0003ZC-Tc for ged-emacs-devel@m.gmane-mx.org; Mon, 26 Sep 2022 16:14:33 +0200 Original-Received: from localhost ([::1]:52860 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ocosS-00008m-6Q for ged-emacs-devel@m.gmane-mx.org; Mon, 26 Sep 2022 10:14:33 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54238) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ocod6-00036n-3J for emacs-devel@gnu.org; Mon, 26 Sep 2022 09:58:44 -0400 Original-Received: from mail-pl1-x636.google.com ([2607:f8b0:4864:20::636]:34411) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ocod4-0000Li-AJ for emacs-devel@gnu.org; Mon, 26 Sep 2022 09:58:39 -0400 Original-Received: by mail-pl1-x636.google.com with SMTP id w13so6339633plp.1 for ; Mon, 26 Sep 2022 06:58:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20210112; h=content-transfer-encoding:mime-version:user-agent:message-id:date :references:in-reply-to:subject:cc:to:from:from:to:cc:subject:date; bh=Iukt7zbilxX5rvcoK/lsfaXrWxaL4VF8JIU41REJAoY=; b=RBpL2aSJRjtIfqHgKj1xxd19GpgLqI8CgWqTBCN3G5+OS76A0Aw77zIAyJ/EA0RLfg d4qlQmpoNpehC11e9xPhI6nJ7faBJY590mPSS8Bxxjhot/kF2DBaMkJWk1ZKVWOr/y42 2nTgbtzvEC6ds/OeuASjXgv1PRUjpIslHJs1vtgoc6WCDOMrS4GrMQYT2ld136/FEmWk vqe5+Is2TEmris5bw4zSetZZghHGqVdtVvGU/1kY8YHmJRS042H6U/7RJgAMwR3kx2ff yJxMB8JeVA484qoT9qKwABNH5l9Yfbidbx9JkpHmunXkOyrJaDHdHBgZts9x4MCr19m5 HkPQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:user-agent:message-id:date :references:in-reply-to:subject:cc:to:from:x-gm-message-state:from :to:cc:subject:date; bh=Iukt7zbilxX5rvcoK/lsfaXrWxaL4VF8JIU41REJAoY=; b=pTMytVUNxK5LQ0lqCDUD0CbDxqMBYNGbJGbZ61SYdsyQnldD5BCdzYfWbcSWrTkaH1 TS6gziUAWFR006HAkkWvj1SUTR/N7q3kAnZH+q5FBiFyh502MS8L2+JFOPdHkNCq2aRq uS1TOMx9umu1gt0/p+/50v49cHDaPuRvxePjqR6AdgMufAa5ybVHxqEV4G1Ha+yWlbIK b10znkv+K+RGiL+xUZc5QUnFJWkFCLv5YC+Hlz/zhNoxLcyq/yiM870mWC+7DcGVsJ4O AtiTg0RX6jCZy6mIRomfqClHbTHDolfvRhG9q4vPisczBbf3pdMZDrf/lZTTCZbvYeV6 soMQ== X-Gm-Message-State: ACrzQf0OIu/ZJhGoHE6lKDsR7kW4wOKM8Lzf9HojN1j4I1s6DI6vnOqZ rdik+4dU8g4Ynp/eX0XRVgBXb0pFKBswnA== X-Google-Smtp-Source: AMsMyM7DOsWeQle0wxWr2bhN0+5OuhdV6tDWqjFZfGxAmdn7/wa3oPQYTrn8QaoNvR9YI95WnH9pFA== X-Received: by 2002:a17:902:7081:b0:178:6154:9d79 with SMTP id z1-20020a170902708100b0017861549d79mr22783769plk.79.1664200714732; Mon, 26 Sep 2022 06:58:34 -0700 (PDT) Original-Received: from raman9 (c-24-4-174-65.hsd1.ca.comcast.net. [24.4.174.65]) by smtp.gmail.com with ESMTPSA id p12-20020a170902e74c00b00176e2fa216csm11249467plf.52.2022.09.26.06.58.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 26 Sep 2022 06:58:34 -0700 (PDT) In-Reply-To: <8735cebqsm.fsf@gnu.org> (Bastien Guerry's message of "Mon, 26 Sep 2022 08:20:40 +0200") Received-SPF: pass client-ip=2607:f8b0:4864:20::636; envelope-from=raman@google.com; helo=mail-pl1-x636.google.com X-Spam_score_int: -175 X-Spam_score: -17.6 X-Spam_bar: ----------------- X-Spam_report: (-17.6 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_MED=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, ENV_AND_HDR_SPF_MATCH=-0.5, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, USER_IN_DEF_DKIM_WL=-7.5, USER_IN_DEF_SPF_WL=-7.5 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:296285 Archived-At: I think there are two (perhaps more) aspects to writing good documentation and accepting / making contributions: 1. The basics -- write a paragraph or two describing some feature. Orthogonal to that and here is where each format bites in different ways: 2. Integrating that contribution into the main corpus of the work --- at the write place, with the right surrounding context, generating the right table-of-contents and menus (a running nightmare in Texinfo if you dont set things up right at the beginning) and so on. I think (2) might likely contribute negatively to (1) happening more often. So rather than arguing about formats (and it's been pointed out already that there are tools for automatic conversion) we should perhaps: A. Create a simple content repository where contributors can check-in their small to medium contributions in the format of their choice (limited to a few open formats) along with the meta-data=20 B. A small group of more experienced volunteers take on the task of incorporating those contributions into the main work. --=20 Thanks, --Raman(I Search, I Find, I Misplace, I Research) =817=A94 Id: kg:/m/0285kf1 =950=DC8