From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: feature/eglot-texi-manual 4725c123f3 2/5: ; eglot.texi: Fix typos and minor inconsistenciesfeature/eglot-texi-manual 4725c123f3 2/5: ; eglot.texi: Fix typos and minor inconsistencies Date: Sun, 23 Oct 2022 06:19:56 -0700 Message-ID: References: <83h6zyye3f.fsf@gnu.org> <87ilkeu3r1.fsf@gmail.com> <87a65qty8a.fsf@gmail.com> <83a65qy57n.fsf@gnu.org> <83h6zvt95q.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6607"; mail-complaints-to="usenet@ciao.gmane.io" Cc: rpluim@gmail.com, emacs-devel@gnu.org To: Eli Zaretskii , rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Oct 24 06:18:08 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 1omouc-0001Vz-Fb for ged-emacs-devel@m.gmane-mx.org; Mon, 24 Oct 2022 06:18:06 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ommVf-0004uI-S0 for ged-emacs-devel@m.gmane-mx.org; Sun, 23 Oct 2022 21:44:11 -0400 Original-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 1omatU-0004M7-PD for emacs-devel@gnu.org; Sun, 23 Oct 2022 09:20:03 -0400 Original-Received: from mail-oi1-x22d.google.com ([2607:f8b0:4864:20::22d]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1omatT-0006H7-7e; Sun, 23 Oct 2022 09:20:00 -0400 Original-Received: by mail-oi1-x22d.google.com with SMTP id p127so8362053oih.9; Sun, 23 Oct 2022 06:19:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:from:to:cc:subject:date:message-id:reply-to; bh=KHFKc2i0q6YBjbN0e+d3ApY8+sL6QbBdEqIpDTSde9A=; b=XLqc0aaunCtcKxuSfbRwFB4P22ltW4EW6S/tOnP5f4J+YEqCWotyubxQBFrb2su6i0 UsPHmm7QOvYtaRdXZNK2ido5ThocXjrufDMm+e6zjbax84bYygrM5CApTPWyKkvCsVv3 wKV4ZMZKuldpuxhPm3Cja7XjLTN7txp4wXWYuLYyf5rszu7raltuQoaXv3A9GBNddV1F 49VdDQxKbgndXHjt1IqQ3qI0Mn20i1t1NiSIzLgpbVuCeesP40IPYxMcWlz0zwI1ETXI PO2q/17Ok40yPaq7wyeCUqzSm3x9U0G/rdnXcbYs2oJ+p8XxWTmICHQrZ82iP8lUKSWd ptqw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=KHFKc2i0q6YBjbN0e+d3ApY8+sL6QbBdEqIpDTSde9A=; b=nZdweir7ZPpc5bqWia0oIuoBmUIOGgbf8IINvdCSUKVUIqePNDL8uo4p+zG9SJU+jj LH4Gx3VPtEsCDwcExBLz8k+cLnDlM9VKXP6ojsriFyvu9VR//GtQXJarXFzYXcbr6gGi 05DwBNGRt5seX+hiamqXkQ6XincksQJ1TEt4gibz5IEzx/sObmnV9smcphkeulxiBWLZ 6+3BqjxqbOv+nNHbcCQU4ZnAT0tGf6w5AoJnkWg280u8EC3b8yaBXIfGWjb0QJmiirZU Dn0lH60pE78xa9fZtX4qlZN8WG1x9I7diDZPIyHsPLIg6hK+0SLdz+uUFs00z2mMvcNn X6ig== X-Gm-Message-State: ACrzQf0JhdC5WqQcyzFCsK2hOrEX1FlrxcZzFHL4xsFEZoA0X2XrxX2w ITHt8bXVht9YXPjkaWWR14Awq//bLVTCcMgVQ7Ut2ev8 X-Google-Smtp-Source: AMsMyM5tvYPO7+vy8UrFFyhzYkHJ8XLw+4FVBVMxZSAh2fGNRgfcyzLNiL6apduRd45Mm+nmbW4DujULxqSBtc8ETyY= X-Received: by 2002:a05:6808:1186:b0:353:b77a:a481 with SMTP id j6-20020a056808118600b00353b77aa481mr28744398oil.199.1666531196955; Sun, 23 Oct 2022 06:19:56 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 23 Oct 2022 06:19:56 -0700 In-Reply-To: <83h6zvt95q.fsf@gnu.org> X-Hashcash: 1:20:221023:eliz@gnu.org::V8gkRw4AvceCkGwb:5XZU Received-SPF: pass client-ip=2607:f8b0:4864:20::22d; envelope-from=stefankangas@gmail.com; helo=mail-oi1-x22d.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.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_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 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:298302 Archived-At: Eli Zaretskii writes: > That manual was written by yours truly. I welcome any improvements to > it and corrections of any mistakes I might have made. But replacing > my style preferences by someone else's is not going to improve the > manual. (For the record, I have no desire to make gratuitous changes, or impose my stylistic preferences on anyone.) We are discussing some changes I made after proofreading the manual. You have claimed that these changes were merely "personal preferences". That description is not just imprecise, but wrong, and can only serve to muddy the waters. In particular, it does not help us think about the changes concretely. But even if a wrong or imperfect edit goes in, it is not a big deal. We review it, improve upon it, and move on. For example, I note that your so-called "undo" of my commit actually kept several of my fixes, and improved further on others.[1] This is expected, and IME exactly how collaborative editing must work. The other thing is the idea to only change things that are "clearly wrong". As this thread demonstrates, it is not trivial to ascertain what is "clearly wrong", not least because, in several cases, opinions abound. The discussion about "that"/"which" is one example. I must also ask whether the many changes you have made to our documentation recently really qualifies as fixing things that are "clearly wrong". I think they do _not_. For example: -Shuts down an the current connection to the language server +This command shuts down the current connection to the language +server You fix such stylistic issues routinely. And not just you. It is actually a good thing. If we disagree about something, we revert, fix, discuss, and improve. In all cases, we are making progress. So what's the problem? Overall, the documentation is slowly getting better over time. AFAICT, it got better from my proofreading too, as much as you don't like to admit it. The proof is all there in the git diff. So this thread is a storm in a tea cup, as far as I'm concerned. Proofreading is thankless enough as it is. We should do everything in our power to encourage and facilitate such work, and not be quick to shoot it down. I can only hope that this thread has not served to discourage anyone from proofreading our manuals in the future. Footnotes: [1] Unfortunately, you also threw away some improvements, for some inexplicable reason. So be it.