[Bug 264411] Contributors to FreeBSD: linking; and "the FreeBSD source tree" is ambiguous (there is not just one tree)

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=264411

            Bug ID: 264411
           Summary: Contributors to FreeBSD: linking; and "the FreeBSD
                    source tree" is ambiguous (there is not just one tree)
           Product: Documentation
           Version: Latest
          Hardware: Any
               URL: https://github.com/freebsd/freebsd-doc/blob/main/docum
                    entation/content/en/articles/contributors/_index.adoc
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Website
          Assignee: doc@FreeBSD.org
          Reporter: grahamperrin@gmail.com

The abstract <https://docs.freebsd.org/en/articles/contributors/#preamble>
might benefit from a link to <https://www.freebsd.org/internal/members/>.
Cross-reference: bug 264410. 

----

Under <https://docs.freebsd.org/en/articles/contributors/#staff-committers>: 

> These are the people who have commit privileges and do the 
> engineering work on the FreeBSD source tree. All 
> core team members are also developers. 
> 
> (in alphabetical order by last name):

For the "source tree" (singular), I assumed /src/

As an example: names include Gordon Bergling, who, according to the three lists
below, has a commit bit for /doc/ but not for /src/

<https://github.com/freebsd/freebsd-src/blob/main/share/misc/committers-doc.dot>
<https://github.com/freebsd/freebsd-src/blob/main/share/misc/committers-ports.dot>
<https://github.com/freebsd/freebsd-src/blob/main/share/misc/committers-src.dot>

– so, a false assumption. 

----

Let's make the descriptive paragraph less ambiguous. Maybe: 

> This list, which includes all members of the Core Team, names everyone 
> who has commit privileges for one or more of the three source trees 
> (doc, ports and src). By surname: 

– and include a link to <https://www.freebsd.org/administration/#t-core>.

-- 
You are receiving this mail because:
You are the assignee for the bug.