Date: Sat, 23 Dec 2023 18:51:31 +0000 From: Ceri Davies <ceri@submonkey.net> To: Moin Rahman <bofh@freebsd.org> Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org Subject: Re: git: 71f0bf9790 - main - .vale/styles: Merge spelling-exceptions Message-ID: <69119D77-379A-48E6-BD07-67385EB2D1CF@submonkey.net> In-Reply-To: <CB7D360A-3C29-4A9F-A778-F69480B27F89@freebsd.org> References: <CB7D360A-3C29-4A9F-A778-F69480B27F89@freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
> On 23 Dec 2023, at 18:43, Moin Rahman <bofh@freebsd.org> wrote: >=20 >>> On Dec 23, 2023, at 7:23 PM, Ceri Davies <ceri@submonkey.net> wrote: >>>=20 >>>> On 23 Dec 2023, at 11:33, Moin Rahman <bofh@freebsd.org> wrote: >>>=20 >>>>> On Dec 23, 2023, at 12:07 PM, Ceri Davies <ceri@submonkey.net> wrote: >>>>>=20 >>>>>=20 >>>>>> On 22 Dec 2023, at 14:59, Muhammad Moinur Rahman <bofh@freebsd.org> 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=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?69119D77-379A-48E6-BD07-67385EB2D1CF>