From nobody Sat Dec 23 18:51:31 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4SyCvH0CbKz54s9W for ; Sat, 23 Dec 2023 18:51:55 +0000 (UTC) (envelope-from ceri@submonkey.net) Received: from mail-wr1-x443.google.com (mail-wr1-x443.google.com [IPv6:2a00:1450:4864:20::443]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1D4" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4SyCvG6swxz3bnW for ; Sat, 23 Dec 2023 18:51:54 +0000 (UTC) (envelope-from ceri@submonkey.net) Authentication-Results: mx1.freebsd.org; none Received: by mail-wr1-x443.google.com with SMTP id ffacd0b85a97d-336788cb261so2415004f8f.3 for ; Sat, 23 Dec 2023 10:51:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=submonkey-net.20230601.gappssmtp.com; s=20230601; t=1703357513; x=1703962313; darn=freebsd.org; h=to:in-reply-to:cc:references:message-id:date:subject:mime-version :from:content-transfer-encoding:from:to:cc:subject:date:message-id :reply-to; bh=6GZWxQVG77fQ1rjO736TIc5iRN+myqvCrW/JcC3zhMk=; b=YEAePtWPM3UrfXYBbzPjkYoXRAn8mnTyWAm5G3fLLBZSaGSR09Qz7f2hXoRniEL+Dq D6pHEr6ft+wW+ZsUOqiHH/WX4OFedsaRr1eyyVPkAjNy+DKF4ZbNyp6iIG368uRymBrT p/H58QmNllVUec4BWyj9G/VhfSwnK5f/9nVrCqui3xYqkBDWmWiafgmxeum1mejJqefx 9R1w7/aP0de9zE266tscJV3CpvKDa9L5bskAGhdDMAOjr5VxP1gd6BQRlsUoHFoduOE6 xznayeImO9W8irLBu15ZaOElZElF3yxuiOEBcXRZOsVkZ8tEAiOvv/7xi2SE0eLKIxDg jygw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1703357513; x=1703962313; h=to:in-reply-to:cc:references:message-id:date:subject:mime-version :from:content-transfer-encoding:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=6GZWxQVG77fQ1rjO736TIc5iRN+myqvCrW/JcC3zhMk=; b=u9SrZIOo4bKllzDtBZ8UtPBkvVNVvtx9MJe/P8L2WUtCMVIPo51LLS82jJ+abVqcx2 0VKFXqLKo6xfhjc7E/kv49+aeUE0a7hdVKlTtAevCS/tuj6aEIBfXd+MLUIibQbjom3B S4q5L/DdcYliEikKEdV1it1xRTK9o0dKtuALqLGAQvEPzm9dW0nbqEbwxTd9Gd111p/Q 28TZptqwMJgIsSjgbyIBhm32zitTovX+9FSOkkBErDTx0gLew8fcKidbIcl18wYsOkP3 egTs9vO1dmTsnnrS6lybFzPUpEUXaPv1GP7V7Oq++dkud0D0Efp2gqMDjkBgVXoUCdc7 S7vA== X-Gm-Message-State: AOJu0YzVqIw41v0K1NGODDQLr9J3/X7HUA9PH+NQoEVjNDLvsj0lmVj9 E0ME3Kenmv5LYbHw4vMH0qrudWs3v22Zp4zyaYmvZ0DpnGJoAyu8 X-Google-Smtp-Source: AGHT+IERdjDtlYGqCpWBLdebo97upH+yryuScTdSGMv0GgiOSIloeOU+XmYG6nOUaL92AxqFrh07Zg== X-Received: by 2002:adf:fa0d:0:b0:336:87f3:b9c2 with SMTP id m13-20020adffa0d000000b0033687f3b9c2mr1725573wrr.61.1703357513407; Sat, 23 Dec 2023 10:51:53 -0800 (PST) Received: from smtpclient.apple ([88.97.110.43]) by smtp.gmail.com with ESMTPSA id k4-20020a5d5244000000b003368c8d120fsm5635955wrc.7.2023.12.23.10.51.52 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sat, 23 Dec 2023 10:51:52 -0800 (PST) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable From: Ceri Davies List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org Mime-Version: 1.0 (1.0) Subject: Re: git: 71f0bf9790 - main - .vale/styles: Merge spelling-exceptions Date: Sat, 23 Dec 2023 18:51:31 +0000 Message-Id: <69119D77-379A-48E6-BD07-67385EB2D1CF@submonkey.net> References: Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org In-Reply-To: To: Moin Rahman X-Mailer: iPhone Mail (21D5026f) X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:15169, ipnet:2a00:1450::/32, country:US] X-Spamd-Bar: ---- X-Rspamd-Queue-Id: 4SyCvG6swxz3bnW > On 23 Dec 2023, at 18:43, Moin Rahman wrote: >=20 >>> On Dec 23, 2023, at 7:23 PM, Ceri Davies wrote: >>>=20 >>>> On 23 Dec 2023, at 11:33, Moin Rahman wrote: >>>=20 >>>>> On Dec 23, 2023, at 12:07 PM, Ceri Davies wrote: >>>>>=20 >>>>>=20 >>>>>> On 22 Dec 2023, at 14:59, Muhammad Moinur Rahman w= rote: >>>>>=20 >>>>> +descendents >>>>=20 >>>> Although I have not checked for the context in which it is used, this w= ord is almost certainly misspelled as =E2=80=9Cdescendent=E2=80=9D is an adj= ective. The noun =E2=80=9Cdescendants=E2=80=9D is most likely the intended u= se. >>> No it's not. The actual word is descendant which can be used as both Nou= n and Adjective and descendents is the plural of that. >>=20 >> That is not correct. Pluralising a noun by adding an =E2=80=9Cs=E2=80=9D= does not frequently - or ever, as far as I can think - change the spelling o= f the rest of a word. >>=20 >> =E2=80=9CDescendent=E2=80=9D, as I said, is an adjective and the plural o= f =E2=80=9Cdescendant=E2=80=9D is =E2=80=9Cdescendants=E2=80=9D. > At the moment I am not in the state to fight over a word. If you think the= word is wrong please find the origin in the doc tree and submit a review or= commit it. It=E2=80=99s definitely wrong. I will change it at some point, but we need t= o be extra careful with words we are adding to the linter. >>>> I am also struggling to ascertain anything in the way of a style guide f= or vale files. Sometimes words with two letters in common are collapsed int= o a single expression, and sometimes they are not. Is there a style guide? >>> I try to concise this file as much as possible. If you mean writing styl= e files check https://vale.sh and if you mean what rules are used in the Fre= eBSD repo check the FDP Primer https://bugs.freebsd.org/bugzilla/show_bug.cg= i?id=3D275224. >>>=20 >>> All the style resides in https://docs.freebsd.org/en/books/fdp-primer/wr= iting-style/#writing-style-linting-vale >>=20 >> I mean the style guide for the vale file itself. There is nothing like t= hat at the link above, so I conclude there is none. Could there be please? > https://docs.freebsd.org/en/books/fdp-primer/writing-style/#writing-style-= linting-vale >=20 > Not sure why my paste was wrong and pointed to a bug report. Thanks, I followed that link too but it does not contain what I was looking f= or. Ceri=20=