Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 23 Dec 2023 18:23:36 +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:  <E56951C1-D9E4-4E96-BF8F-A47844D87A07@submonkey.net>
In-Reply-To: <CF7222A4-0C15-4902-82BA-05AF5E8960C7@freebsd.org>
References:  <CF7222A4-0C15-4902-82BA-05AF5E8960C7@freebsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help


> On 23 Dec 2023, at 11:33, Moin Rahman <bofh@freebsd.org> wrote:
>=20
>=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> wro=
te:
>>>=20
>>> +descendents
>>=20
>> Although I have not checked for the context in which it is used, this wor=
d is almost certainly misspelled as =E2=80=9Cdescendent=E2=80=9D is an adjec=
tive. The noun =E2=80=9Cdescendants=E2=80=9D is most likely the intended use=
.
> No it's not. The actual word is descendant which can be used as both Noun a=
nd Adjective and descendents is the plural of that.

That is not correct.  Pluralising a noun by adding an =E2=80=9Cs=E2=80=9D do=
es not frequently - or ever, as far as I can think - change the spelling of t=
he rest of a word.

=E2=80=9CDescendent=E2=80=9D, as I said, is an adjective and the plural of =E2=
=80=9Cdescendant=E2=80=9D is =E2=80=9Cdescendants=E2=80=9D.


>> I am also struggling to ascertain anything in the way of a style guide fo=
r vale files.  Sometimes words with two letters in common are collapsed into=
 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 style f=
iles check https://vale.sh and if you mean what rules are used in the FreeBS=
D repo check the FDP Primer https://bugs.freebsd.org/bugzilla/show_bug.cgi?i=
d=3D275224.
>=20
> All the style resides in https://docs.freebsd.org/en/books/fdp-primer/writ=
ing-style/#writing-style-linting-vale

I mean the style guide for the vale file itself.  There is nothing like that=
 at the link above, so I conclude there is none. Could there be please?

Ceri



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?E56951C1-D9E4-4E96-BF8F-A47844D87A07>